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Note 
Before using this information and the product it supports, be sure to read the general information under 
“Notices” on page iii. 


Third Edition (January 1991) 


This book applies to the IBM 3880 Storage Control only. For information regarding the IBM 3990 Storage 
Control see the /BM 3990 Storage Control Planning, Installation, and Storage Administration guide. 


Requests for IBM publications should be made to your IBM representative or to the IBM branch office 
serving your locality. If you request publications from the address given below, your order will be delayed 
because publications are not stocked there. 


A Reader’s Comment Form is provided at the back of this publication. If the form has been removed, 
comments may be addressed to IBM Corporation, Department 61C, Tucson, Arizona 85744. IBM may use 
or distribute whatever information you supply in any way it believes appropriate without incurring any 
obligation to you. 


© Copyright International Business Machines Corporation 1987, 1989, 1991. All rights reserved. 
_ Note to U.S. Government Users — Documentation related to restricted rights — Use, duplication or 
disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp. © 


Notices 


References in this publication to IBM products, programs or services do not imply 
that IBM intends to make these available in all countries in which IBM operates. 
Any reference to an IBM licensed product, program, or service is not intended to 
state or imply that only IBM’s product, program, or service may be used. Any 
functionally equivalent product, program, or service that does not infringe any of 
IBM's intellectual property rights may be used instead of the IBM product. 
Evaluation and verification of operation in conjunction with other products, except 
those expressly designated by IBM, is the user’s responsibility. 


This manual is intended to help the user use the LISTDATA routine of the Cache RMF Reporter to obtain 
subsystem status or counts information. 


This manual also documents Product-Sensitive Programming Interface and Associated Guidance 
Information. 


Product-Sensitive programming interfaces allow the installation to perform tasks such as diagnosing, 
modifying, monitoring, repairing, tailoring, or tuning of this IBM software product. Use of such 
interfaces creates dependencies on the detailed design or implementation of the |BM software product. 
Product-Sensitive programming interfaces should be used only for these specialized purposes. 
Because of their dependencies on detailed design and implementation, it is to be expected that 
programs written to such interfaces may need to be changed in order to run with new product releases 
or versions, or as a result of service. 


Product-Sensitive Programming Interface and Associated Guidance Information is identified where it 
occurs, either by an introductory statement to a chapter or section or by the following marking: 


[ Product-Sensitive Programming Interface OO 


Product-Sensitive Programming Interface and Associated Guidance Information... 


Pee ee End of Product-Sensitive Programming Interface ee oa bs See 


IBM may have patents or pending patent applications covering subject matter in 
this document. The furnishing of this document does not give you any license to 
these patents. You can send license inquiries, in writing, to the IBM Director of 
Commercial Relations, IBM Corporation, Purchase, NY 10577. 
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Electronic Emission Notices 


Federal Communications Commission (FCC) Statement 


Warning: This equipment generates, uses, and can radiate radio frequency energy 
and if not installed and used in accordance with the instructions manual, may 
cause interference to radio communications. It has been tested and found to 
comply with the limits for a Class A computing device pursuant to Subpart J of Part 
15 of FCC Rules, which are designed to provide reasonable protection against such 
interference when operated in a commercial environment. Operation of this 
equipment in a residential area is likely to cause interference in which case the 
user at his own expense will be required to take whatever measures may be 
required to correct the interference. 


Instructions to User: Properly shielded and grounded cables and connectors must 
be used for connection to peripherals in order to meet FCC emission limits. Proper 
cables are available from IBM. IBM is not responsible for any radio or television 
interference caused by using other than recommended cables or by unauthorized 
modifications to this equipment. It is the responsibility of the user to correct such 
interference. 


Canadian Department of Communications compliance statement 


This equipment does not exceed Class A limits per radio noise emissions for 
digital apparatus, set out in the Radio Interference Regulation of the Canadian 
Department of Communications. Operation in a residential area may cause 
unacceptable interference to radio and TV reception requiring the owner or 
operator to take whatever steps are necessary to correct the interference. 


Avis de conformité aux normes du ministere des Communications du Canada 


Cet equipement ne dépasse pas les limites de Classe A d’emission de bruits 
radioélectriques pour les appareils numeriques, telles que prescrites par le 
Reglement sur le brouillage radioélectrique établi par le ministere des 
Communications du Canada. L’exploitation faite en milieu residentiel peut 
entrainer le brouillage des receptions radio et télé, ce qui obligerait le proprietaire 
ou l’opérateur a prendre les dispositions nécessaires pour en éliminer les causes. 


The United Kingdom Telecommunications Act 1984 
This apparatus is approved under the approval No. NS/G/23/J/100003 for the 


indirect connections to the public telecommunications systems in the United 
Kingdom. 
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Trademarks and Service Marks 


Y The following terms, denoted by an asterisk (*), used in this publication, are 
mr trademarks or service marks of the IBM Corporation in the United States or other 
countries: 
DFSMS ESA/370 Enterprise Systems Architecture/370 
ECKD IBM NetView MVS 
MVS/DFP MVS/ESA MVS/SP MVS/XA 
VM VM/XA 3090 


Summary of Changes 


| 

| This book is for the user of the !BM 3880 Storage Contro! Most references to the 
| 3990 Storage Control have been removed in this edition. Any user who wants to 

| find information on the 3990 Storage Control such as IDCAMS commands for 3990 
| basic functions or extended functions should see the /BM 3990 Storage Control 

| Planning, Installation, and Storage Administration manual. Information on the 

| Interactive Storage Management Facility (ISMF) panel support for monitoring and 
| controlling 3990 Storage Controls is in the /SMF User’s Guide. 


Notices V 
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( Chapter 1. Preface 


This book is part of the Storage Subsystem Library (SSL) — a set of books that 
provides information about the hardware components of IBM disk storage 
subsystems. The SSL includes both direct access storage (DAS) and storage 
control publications. 


This book specifies the access method services tools for administering a 3880 
storage control with cache under MVS. 


About This Book 


| 

| This book is a guide for the storage administrator, system programmer, or 

| hardware performance specialist who is responsible for providing and maintaining 
| required levels of storage subsystem availability and performance. 


Terminology 


A comprehensive glossary is provided at the back of this book. This glossary 
contains terms used not only in this book but also terms, abbreviations, and 
acronyms from other books in the Storage Subsystem Library. 


The Storage Subsystem Library 


The Storage Subsystem Library describes characteristics, capabilities, and 
features of the hardware and provides instructions for installing, using, and 
maintaining storage subsystem components effectively in various IBM operating 
environments. The library is designed to provide hardware and software related 
information for DAS and storage controls. 


Figure 10n page 4 shows the relationships among the 3990, 3390, and 3380 SSL 
books in terms of high-level tasks described in each book. 


Storage Control Publications 
The 3990 subset of the SSL includes: 


e /BM 3990 Storage Control introduction, GA32-0098 


Provides a complete description of the various models of the 3990 Storage 
Control, including its data availability, performance, and reliability 
improvements over previous storage controls. In addition, the book provides 
descriptions of the configuration attachment options, optional features, 
performance characteristics, and software support of the 3990 Storage Control. 


e /BM 3990 Storage Control Planning, Installation, and Storage Administration 
Guide, GA32-0100 


Provides a functional description of the 3990 Storage Control. The book 

describes the planning, program installation, and storage management tasks 

e used in typical environments. Configuration examples as well as sample 

( programs for controlling the various functions of the 3990 Storage Control are 
: provided. 
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e /BM 3990 Storage Control Reference, GA32-0099 


Provides descriptions and reference information for the 3990 Storage Control. i 7 
The book contains channel commands, error recovery, and sense information. 


e Cache Device Administration, GC35-0101 


Specifies the access method services tools for administering a 3880 Storage 
Control with cache under MVS. The book supports only the 3880 Storage 
Control models with cache. 


e /BM 3990 Operations Study Guide, GA32-0131 


A study guide for operators of 3990 storage subsystems. Provides general 
information on system control program commands and messages, and 
guidelines for basic problem determination. 


3390 Publications 
The 3390 subset of the SSL includes: 


e /BM 3390 Direct Access Storage Introduction, GC26-4573 


Provides a complete description of each 3390 model, including characteristics, 
features, and capabilities. In addition, the configuration and attachment 
options are described along with other information that will help you design a 
subsystem to meet your needs. 


e Using IBM 3390 Direct Access Storage in an MVS Environment, SC26-4574 


Provides specific guidance for using 3390s in an MVS/ESA, MVS/XA or 

MVS/370 operating environment. The book provides detailed instruction for | ; 
planning the addition of new 3390 devices, installing devices, moving data to e* 
new devices, and performing ongoing storage subsystem management. 


e Using IBM 3390 Direct Access Storage in a VM Environment, SC26-4575 


Provides specific guidance for using 3390s in a VM/SP HPO, or VM/XA SP 
operating environment. The book provides detailed instruction for planning the 
addition of new 3390s, installing devices, moving data to new devices, and 
performing ongoing storage subsystem management. In addition, storage 
considerations related to guest systems are addressed. 


e /BM 3390 Direct Access Storage Reference Summary, GC26-4577 


Provides a summary of 3390 capacity, performance, and operating 
characteristics. 


3380 Publications 
The 3380 subset of the SSL includes: 


e /BM 3380 Direct Access Storage Introduction, GC26-4491 


Provides a complete description of the various models of the 3380, including 
characteristics, features, and capabilities. In addition, the configuration and 
attachment options are described along with other information that helps in 
designing a storage subsystem to meet your needs. This book does not cover 
3380 Model CJ2. 


e /BM 3380 Direct Access Storage Direct Channel Attach Model CJ2 Introduction 
and Reference, GC26-4497 a 


Provides a complete description of the 3380 direct channel attach Model CJ2 ae, 
characteristics, features, capabilities, and string configuration options. 
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e Using the IBM 3380 Direct Access Storage in an MVS Environment, GC26-4492 


operating environment. The book provides detailed instruction for planning the 
addition of new 3380 devices from a logical and physical point of view, 
installing devices, moving data to new devices, and performing some ongoing 
activities to maintain a reliable storage subsystem. 


e Using the IBM 3380 Direct Access Storage in a VM Environment, GC26-4493 


Provides specific guidance for using the 3380 in a VM/SP, VM/SP HPO, or 
VM/XA SP operating environment. The book provides detailed instruction for 
planning the addition of new 3380 devices, installing devices, moving data to 
new devices, and performing ongoing storage management activities to 
maintain reliable performance and availability. In addition, hardware 
considerations related to guest systems are addressed. 


e Using the IBM 3380 Direct Access Storage in a VSE Environment, GC26-4494 


( | Provides specific guidance for using the 3380 in an MVS/XA or MVS/370 


The book provides instruction for planning the addition of new 3380 devices, 
installing devices, moving data to new devices, and performing ongoing 
storage subsystem management. 


e /BM 3380 Direct Access Storage Reference Summary, GX26-1678 


( Provides specific guidance for using the 3380 in a VSE operating environment. 


Provides a summary of 3380 capacity, performance, and operating 
characteristics. 


a Shared SSL Publications 
( . The following publications contain information relevant to the entire Storage 
| Subsystem Library. 


e Maintaining IBM Storage Subsystem Media, GC26-4495 


Describes how the storage subsystem and the various operating systems 
handle disk storage errors and provides instruction on using the Environmental 
Record Editing and Printing (EREP) program and the Device Support Facilities 
(ICKDSF) program to diagnose and correct disk media errors. Recovery 
procedures are provided for the various device types. In addition, background 
material on DAS storage concepts is included. 


e Storage Subsystem Library Master Index, GC26-4496 


Provides a central source for information related to storage subsystem topics. 
Books for IBM 3390 DAS, IBM 3380 DAS, and 3990 Storage Controls are 
indexed in this publication. An overview of the material in the Storage 
Subsystem Library is provided with this index. 
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Storage Subsystem Library | 


Task-Oriented 
Manuals 


Reference 
Manuals 


Index, and 
Glossary 


GC26-4496 


3380 DASD 7 


IBM 3380 Direct Access 
Storage Introduction, 


GC26-4491 


IBM 3380 Direct Access Storage 
Direct Channel Attach Model CJ2 
Introduction and Reference, 


GC26-4497 


Using the IBM 3380 Direct Access 
Storage inan MVS Environment, 
GC26-4492 


Using the IBM 3380 Direct Access 
Storage in a VM Environment, 
GC26-4493 


Using the IBM 3380 Direct Access 


Storage ina VSE Environment, 
GC26-4494 


IBM 3380 Direct Access Storage 
Direct Channel Attach Model CJ2 
Introduction and Reference, 
GC26-4497 


Maintaining IBM Storage 


Subsystem Media, 
GC26-4495 


IBM 3380 Direct Access 


SSL | Maintaining 
Master 
Bibliography 


IBM 3990 Storage 
Control Introduction, 
GA32-0098 


Introduction to 
Nonsynchronous Direct 
Access Storage Subsystems, 
GC26-4519 


IBM 3990 Storage Control 
Planning, Installation, and 
Storage Administration Guide, 
GA32-0100 


Cache Device Administration, 
GC35-0107 | 


IBM 3990 Operations 
Study Guide, GA32-0131 


IBM 3990 Storage Control 
Reference, GA32-0099 


IBM 3990 Operations and 
Recovery Reference, 
GA32-0133 


Storage Reference Summary (card), 


GX 26-1678 
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IBM 
Storage 
Subsystem 
Media 


GC26-4495 


/] 


XQ 3390 DASD 


IBM 3390 Direct Access 
Storage Introduction, 
GC26-4573 


Using IBM 3390 Direct Access 
Storage inan MVS Environment, 
GC26-4574 


Using IBM 3390 Direct Access 
Storage ina VM Environment, 
GC26-4575 


Using IBM 3390 Direct Access 
Storage ina VSE Environment, 
GC26-4576 


| Maintaining IBM Storage 


Subsystem Media, 
GC26-4495 


IBM 3390 Direct Access 
Storage Reference Summary 
(cara), GX26-4577 
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Storage Subsystem Library Ordering Information 


( : The entire SSL or parts of it tailored to your hardware and software environment 
= can be ordered with bill of form numbers. 


3390 and 3990 Publications 
You can obtain a copy of every manual in the 3390 and 3990 subsets of the SSL 
with one order number, SBOF-3124. Select one of the following bill of form 
numbers to obtain information tailored to your hardware and software 
environment. To obtain an individual manual, use its order number. 


Table 1. 3390 and 3990 Subsets 


MVS VM 3990 
SBOF- SBOF- GBOF- SBOF- 
3121 3122 0366 3124 


IBM 3390 Direct Access Storage 
( Introduction, GC26-4573 


Using IBM 3390 Direct Access Storage 
inan MVS Environment, SC26-4574 


Using IBM 3390 Direct Access Storage 
ina VM Environment, SC26-4575 


Maintaining IBM Storage Subsystem Media, 
GC26-4495 


IBM 3390 Direct Access Storage 


Reference Summary, GX26-4577 
IBM 3990 Storage Control Introduction, 


( GA32-0098 
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3380 and 3990 Publications : | 
You can obtain a copy of every manual in the 3380 and 3990 subsets of the SSL ae. 
using one General Bill of Forms (GBOF) number, GBOF-1762. Select one of the 
following bill of form numbers to obtain information tailored to your hardware and ai 
software environment. To obtain an individual manual, use its order number. 


Table 2. 3380 and 3990 Subsets 


VSE CJ2/MVS CJ2/VM CJ2/VSE 
Bene: Sack: GBOF- GBOF- GBOF- GBOF- ena 


1756 1757 1758 1759 1760 1761 0366 


IBM 3380 Direct Access Storage 
Introduction, GC26-4491 


IBM 3380 Direct Access Storage 
Direct Channel Attach Model CJ2 


Introduction and Reference, GC26-4497 


Using IBM 3380 Direct Access Storage 
inan MVS Environment, GC26-4492 


Using IBM 3380 Direct Access Storage 

ina VM Environment, GC26-4493 

Using IBM 3380 Direct Access Storage x Xx 
ina VSE Environment, GC26-4494 

Maintaining IBM Storage Subsystem Media, 

GC26-4495 


IBM 3380 Direct Access Storage 
Reference Summary, GX26-1678 


IBM 3990 Storage Control 
Introduction, GA32-0098 peo 


IBM 3990 Storage Control Planning, 
Installation, and Storage Administration 
Guide, GA32-0100 


IBM 3990 Storage Contro/ Reference, GA32-0099 X 
Cache Device Administration, GC35-0101 
IBM 3990 Operations Study Guide, GA32-0131 


Storage Subsystem Library Master Xx 


Bibliography, Index, and Glossary, GC26-4496 


Binder and 3380 inserts, GX26-3767 
Binder and 3990 inserts, GX26-3768 


Storage Subsystem Library Binders 
Binder kits are available to help organize your library. Kits consist of a binder with 
identifying cover and spine inserts for 3390, 3380, or 3990 manuals, and are 
included when you order the following numbers: 


SBOF-3121 and SBOF-3122 include a binder with 3390 inserts. 
GBOF-1756 through GBOF-1761 include a binder with 3380 inserts. 
GBOF-0366 includes a binder with 3990 inserts. 

SBOF-3124 includes binders and inserts for both 3990 and 3390. 
GBOF-1762 includes binders and inserts for both 3990 and 3380. 


Binder kits may also be ordered separately. 


e Order number SX26-3777 contains a binder and 3390 inserts. 
e Order number GX26-3767 contains a binder and 3380 inserts. 
e Order number GX26-3768 contains a binder and 3990 inserts. 
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Related Publications 


( “Bibliography” on page 81 contains a list of publications that are referred to in this 
) book or that may provide additional, related information. The bibliography 
includes a short description of each publication. 
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Chapter 2. Introduction 


This book describes the access method services commands for managing the IBM 
3880 storage controls that have cache storage. These commands are presented in 
the following chapters with one chapter for each storage control. Table 3 lists 
each storage control and shows which commands it supports. If the command is 
supported, the page number explaining the command is given. 


Table 3. Command to Model Cross-Reference Table 


LISTDATA SETCACHE | 


Note: 


3880 Model 13 also supports the BINDDATA command. 
see “BINDDATA” on page 39 for information on this command. 


For basic understanding of the IBM 3880 Models 11, 13, 21, and 23, see the 
respective introduction book. 


For an explanation of the coding and syntax rules for access method services 
commands, see Access Method Services Reference. 
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DFP Support 


Table 4 shows the minimum levels of Data Facility Product (DFP) that support the | 
various cache storage controls. 


Table 4. Levels of DFP Supporting Cache Storage Controls 
Storage Control MVS/DFP DFP/XA . DFP/XA MVS/370 
| Ver. 3 Ver. 2 Ver. 1 DFP Ver. 1 
3880-23 2.3 1.3 1.2 
(with Feature 3010) 

3880-23 

(without Feature 3010) 


Syntax Conventions 


In this book, the following conventions are used to show command syntax: 
[ ] brackets indicate an optional parameter. 


{ } braces indicate a choice of entry; unless a default is shown, you must 
choose one of the entries within the braces. 


| vertical bar indicates alternative items. You cannot select more than one 
item. 


BOLDFACE type indicates the exact character must be entered. 
italic type indicates fields that you must supply. 


BOLDFACE UNDERSCORE type indicates a default. If the parameter is 
omitted, the underscored value is assumed. 
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System Authorization Facility 


The following table show the SAF/RACF resources that are used to protect the 
shown commands and parameters. 


To use a command and any of its parameters, you must be authorized to use both 
the command and its parameter. See your RACF administrator or system 
programmer for RACF authorization. 


Table 5. SAF/RACF Resources. SAF/RACF resource access required for |DCAMS commands. 


BINDDATA FACILITY STGADMIN.IDC.BINDDATA | READ | 


LISTDATA FACILITY STGADMIN.IDC.LISTDATA 
SETCACHE FACILITY STGADMIN.IDC.SETCACHE | READ | 


( | SUBSYSTEM FACILITY STGADMIN.IDC.SETCACHE.SUBSYSTEM | READ | 


Note: Each authorization check is performed independently. To issue a command using a protected parameter, the user must 
have READ access authority to the resource for the command, as well as to the resource for the parameter. For example, to 
issue a SETCACHE SUBSYSTEM command, a user must have READ access to both of the following: 


¢ STGADMIN.IDC.SETCACHE 
¢ STGADMIN.IDC.SETCACHE.SUBSYSTEM 
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LISTDATA 


The LISTDATA command obtains information about activity within the IBM 3880 
Storage Control Model 23 including the Model 23 with the 3380 AJ4/AK4 
Attachment (Feature 3010). You can obtain two different types of reports: 


e Subsystem Counters Report—a record of the counters within the subsystem at 
the time the report is requested. 


e Subsystem Status Report—a record of the status within the subsystem at the 
time the report is requested. 
e With either type of report, you can request a legend that describes the headings 
( used. 
A user interface has been provided specifically for non-access method services 
callers (for example, the Cache RMF Reporter). This interface allows you to obtain 
subsystem status or count information. The description of the interface is in 


Appendix B, “User Access to Subsystem Status and Counts Information” on 
page 67. 


Note: The LISTDATA command is protected by SAF/RACF resources, see “System 
( Authorization Facility” on page 11 for further information. 


The format of the LLSTDATA command is: 


Table 6. LISTDATA command format, 3880 Model 23 


LISTDATA {COUNTS|STATUS} 
{FILE(ddname)|VOLUME(vo/ser) UNIT(unittype)} 


[DEVICE|SUBSYSTEM|ALL] 
[LEGEND|NOLEGEND] 
( [OUTFILE(ddname)|OUTDATASET(dsname)] 


[WTO] 
LISTDATA can be abbreviated: LDATA 


Required Parameters 
COUNTS|STATUS 
specifies the type of report. 


COUNTS 
specifies that a subsystem counters report be printed. 


Abbreviation: CNT 


STATUS 
specifies that a subsystem status report be printed. 


( Abbreviation: STAT 
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FILE(ddname)|VOLUME(vo/ser) UNIT(unittype) 
specifies a device that resides in the a a for which the report is 
requested. | 


BIpE(oname) | | 
specifies the name of a DD statement that identifies the unit and volume of 
a device within the subsystem. For ddname, substitute the name of the DD 
statement identifying the device type and volume serial number. 


VOLUME (vo/ser) : 
specifies the volume serial number of a svelte within the subsystem. For 
volser, substitute the volume serial number of the volume. 


Abbreviation: VOL 


UNIT(unittype) 
specifies the unit type of the stibsystem: This parameter is required only 
when the VOLUME parameter is specified. 


Optional Parameters 
DEVICE|SUBSYSTEM|ALL 
specifies the subsystem counters to be reported in the subsystem counters 
report. These parameters can be specified only when the COUNTS parameter 
is specified. 


DEVICE 
specifies that the subsystem counters for the addressed device are 
included in the subsystem counters report. 


Abbreviation: DEV 


SUBSYSTEM 
specifies that the subeveie: sooner for all devices within the subsystem 
are included in the subsystem counters report. 


Abbreviation: SSYS or SUBSYS 


ALL | 
specifies that subsystem counters for all devices on all like models of 
storage controls are to be included in the subsystem counters report. ALL 
is the default parameter when the COUNTS parameter is specified. 


LEGEND|NOLEGEND 
specifies whether a legend explaining the headings used is to be printed 
following the requested report. 


LEGEND 
specifies that the legend is printed. 


Abbreviation: LGND 


NOLEGEND | 
specifies that the legend is not printed. This is the default parameter. 


Abbreviation: NOLGND 
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OUTFILE(ddname)|OUTDATASET(dsname) 
specifies an alternate target data set if the SYSPRINT data set is not to be used 
for the report. 


OUTFILE(ddname) 
specifies the name of a DD statement identifying the data set to be used to 
contain the report. For ddname, substitute the name of the DD statement 
identifying the data set. 


Abbreviation: OFILE 


OUTDATASET(dsname) 
specifies the name of the alternate target data set. For dsname, substitute 
the name of the data set to be used. The data set name must be cataloged. 


Note: Be sure to erase the previous alternate target data set before 
specifying the OUTDATASET parameter. If you do not erase the old 
data set, your reports may not be accurate. If a report seems to be 
in error, compare the time field with the time the job was submitted. 


Abbreviation: ODS or OUTDS 


WTO 
specifies that information on the overall condition of the subsystem be sent to 
the system console and a full report printed. 


Abbreviation: None 


Note: The WTO parameter can be used only if the STATUS parameter is 
specified. 


Examples 


Listing Subsystem Counters for a Particular Device: Example 1 
In this example, a Subsystem Counters Report for a particular device is being 
requested. 


//LISTDAT1 JOB... 
//STEPI EXEC PGM=IDCAMS 
//LISTVOL1 DD — UNIT=3380,VOL=SER=V0L123, DISP=SHR 
//SYSPRINT 0D  SYSOUT=A 
//SYSIN DD * 
LISTDATA- 
COUNTS- 
FILE(LISTVOL1) - 
DEVICE 


‘sl 
Job control language statement: 


e LISTVOL1 DD, which specifies : a 3380 unit and volume VOL123 for which the 
report is requested. 
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— The LISTDATA command parameters are: 


e COUNTS, which specifies that a Subsystem Counters Report be printed. 


e FILE, which specifies LISTVOL1 as the DD statement that allocates a 3380 unit 
and volume VOL123. 


e DEVICE, which specifies that the Subsystem Counters Report should include 
only subsystem counters for the addressed device. 


See “Reports” on page 18, for an example of a printed Subsystem Counters 
Report. | 


Listing Subsystem Counters for All Devices within a Subsystem: Example 2 


In this example, a Subsystem Counters Report is being requested for all devices 
within a subsystem. 


//LISTOAT2 JOB... | 
//STEP1 EXEC PGM=IDCAMS . 
//OUTDD OD _—_ DSN=OUTDS,DISP=(NEW,KEEP) , VOL=SER=OUTVOL, 
// UNIT=3480 , DCB=(RECFM=VBA, LRECL=125, BLKSIZE=629) 
//SYSPRINT DD  SYSOUT=A 
//SYSIN. DD * 
LISTDATA- 
COUNTS- | 
VOLUME (VOL002) - 
UNIT (3380) - 
-SUBSYSTEM- 
OUTFILE(OUTDD) 
Vhs 


Job control language statement: 


e OUTDD DD, which allocates the output data set (DSN =OUTDS) on tape 
(UNIT =3480) for use by the LISTDATA command. If you do not allocate an 
output data set, the subsystem counters are printed on the SYSPRINT data set. 
The DCB parameter is required for the alternate output data set if it is new. 
The LISTDATA command parameters are: 
~@ COUNTS, which specifies that a Subsystem Counters Report is printed. 
e VOLUME, which specifies volume VOLOO2. 
e UNIT, which specifies a 3380 unit. 


e SUBSYSTEM, which specifies that the Subsystem Counters Report should 
include counters for all devices within this subsystem. 


e OUTFILE, which specifies OUTDD as the name of the DD statement identifying 


the data set used to contain the report. 


See “Reports” on page 18, for an example of a printed Subsystem Counters 
Report. 
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Listing Subsystem Counters for All Devices on All Like Subsystems: Example 3 
In this example, a Subsystem Counters Report is being requested for all devices on 
all like subsystems. 


//LISTDAT3 JOB 


//STEP1 EXEC PGM=IDCAMS 
//OUTDS DD  DSN=OUTDATA,DISP=(,CATLG) , UNIT=3380, 


// 
// 


VOL=SER=VOL001, SPACE=(CYL,(2,1)), 
DCB=(RECFM=VBA, 
LRECL=250 , BLKSIZE=504) 


// 
//SYSPRINT 0D  SYSOUT=A 
//SYSIN pp * 


ti 


LISTDATA- 


COUNTS- 

VOLUME (VOL002) - 
UNIT (3380) - 

Ack 

OUTDATASET (OUTDATA) 


Job control language statement: 


OUTDS DD, which allocates the output data set (DSN =OUTDATA) on a 3380 
(UNIT =3380) for use by the LISTDATA command. If an output data set is not 
allocated, the report is printed on the SYSPRINT data set. The DCB parameter 
is required for the alternate output data set. The output data set is cataloged in 
the master catalog (DISP =(,CATLG)). This DD statement allocates 2 cylinders 
for the output data set and, if more space is required for the report, the space 
is extended in increments of 1 cylinder. 


The LISTDATA command parameters are: 


COUNTS, which specifies that a Subsystem Counters Report be printed. 
VOLUME, which specifies volume VOLOO2. 
UNIT, which specifies a 3380 unit. 


ALL, which specifies that the Subsystem Counters Report should include 
subsystem counters for all devices on all like subsystems. 


OUTDATASET, which identifies OUTDATA as the output data set to be used for 
the report, rather than the SYSPRINT data set. 


see “Reports” on page 18, for an example of a printed Subsystem Counters 
Report. 


Listing Subsystem Status: Example 4 
In this example, subsystem status report is being requested. 


//LISTDAT4 JOB. 

//STEP1 EXEC PGM=IDCAMS 

//LISTVOL2 0D —-UNIT=3380,VOL=SER=VOL269, DISP=SHR 
//SYSPRINT DD  SYSOUT=A 

//SYSIN DD * 


Vhs 


LISTDATA- 


STATUS- 
FILE(LISTVOL2) - 
WTO 
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i Job control language statement: 


—@ LISTVOL2 DD, which specifies a 3380 unit for which subsystem status is being 
reported. 


The LISTDATA command parameters are: 
e STATUS, which specifies that a Subsystem Status Report be printed. 


e FILE, which specifies LISTVOL2 as the DD statement that allocates a 3380 unit 
and volume VOL269. 


e WTO which specifies that an informational message indicating the status of 
subsystem caching activity will be displayed on the system console. For 
example, WTO may produce a message similar to the one below: 


IDCQ15511 3380 CACHING STATUS: ACTIVE FOR SD X'05' DEV ID xX'01' 


Reports 
Use the LISTDATA command to list information about activity within the IBM 3880 
Storage Control! Model 23. You can obtain two different types of reports: 
subsystem counters report and subsystem status report. Optionally, you can also 
obtain a legend for each report. This legend describes the headings used in the 
report. When you request a legend, it is printed at the end of the report. 


Subsystem Counters Report 
The Subsystem Counters Report provides a record of the counters within the 
subsystem at the time the report is requested. The counters are not reset when the 
report is taken. 


Figure 20n page 19 is a sample Subsystem Counters Report for Model 23. 
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IDCAMS SYSTEM SERVICES TIME: 12:29:08 
f | 3380 SUBSYSTEM COUNTERS REPORT 


VOLUME 338DHO DEVICE ID X'CO' 
CHANNEL COMMAND CHAINS IN BYTES 


eer SEARCH/READ......+-- 
REQUESTS —«sSD_ID TOTAL CACHE READ WRITE TOTAL 
NORMAL X' FB! 29 28 24 
XE A! 30 28 15 
SEQUENTIAL  X'FB! 6 5 1 
XIE A! 6 5 2 
TOTAL/1000 9 9 9 
REQUESTS SD ID COMMAND CHAINS 
( INHIBIT CACHE LOADING X'FB! 9 
. XIE A! 9 
BYPASS CACHE X'EB! 38 
XIE A! 39 
DASD TO CACHE XFERS SD ID NORMAL SEQUENTIAL 
X'EB! 2 1 
XE A! 3 1 
( CONTROL UNIT DATA TRANSFER IN BYTES 
| SD ID CACHE/CHAN DASD/CHAN DASD/CH&CA DASD /CACHE 
X' EB! 8392 41776 1264 3552 
XE A! 8434 4a54a4 1408 11152 


Figure 2. Sample Subsystem Counters Report for the IBM 3880 Storage Control Model 23 


The report in Figure 30n page 20 is the corresponding legend of Figure 2. 


Chapter 3. 3880 Model 23 Commands 19 


IDCAMS SYSTEM SERVICES TIME: 12:29:08 


LEGEND 


SUBSYSTEM COUNTERS LEGEND 


VOLUME - VOLUME SERIAL NUMBER FOR WHICH THE DATA IS GATHERED 
DEVICE ID - DEVICE IDENTIFICATION 
SD ID - STORAGE DIRECTOR FOR WHICH DATA IS GATHERED 
CHANNEL COMMAND CHAINS - A CCW CHAIN WHICH CONTAINS AT LEAST ONE 
SEARCH, READ OR WRITE, COUNTS ARE IN BYTES 
SEARCH/READ - CCW CHAINS WHICH CONTAIN AT LEAST ONE SEARCH OR 
READ BUT NO WRITE CCW 
TOTAL - ALL SEARCH/READ CCW CHAINS 


CACHE READS” - 
WRITE TOTAL - 
NORMAL - 


SEQUENTIAL - 


TOTAL/1000 ‘ 


CCW CHAINS WHICH REQUIRED NO DATA TO BE MOVED 
TO/FROM THE DASD 
ALL WRITE CCW CHAINS 


CCW CHAINS WHICH DO NOT INCLUDE A DEFINE EXTENT CCW 
OR SPECIFY NORMAL CACHE REPLACEMENT IN THE DEFINE 
EXTENT CCW 


CCW CHAINS WHICH SPECIFY SEQUENTIAL ACCESS IN THE 
DEFINE EXTENT CCW 


TOTAL DIVIDED BY 1000 FOR EACH VERTICAL LINE ITEM 


INHIBIT CACHE LOADING - CCW CHAINS WHICH SPECIFY INHIBIT CACHE LOADING 


BYPASS CACHE - 


IN THE DEFINE EXTENT CCW 
CCW CHAINS WHICH SPECIFY THE BYPASS CACHE ATTRIBUTE 
IN THE DEFINE EXTENT CCW 


DASD TO CACHE TRANSFERS - THE NUMBER OF DATA PROMOTION OPERATIONS WHICH 


NORMAL : 
SEQUENTIAL - 


MOVE DATA FROM THE DASD TO THE CACHE 

DATA MOVEMENT OPERATIONS EXCLUDING SEQUENTIAL 

'NEXT TRACK' DATA MOVEMENT OPERATIONS IN SEQUENTIAL 
ACCESS MODE 


CONTROL UNIT DATA TRANSFER IN BYTES 


CACHE /CHAN : 
DASD/CHAN : 
DASD/CH&CA . 


DASD /CACHE : 


BYTES TRANSFERRED FROM CACHE TO THE CHANNEL 
BYTES TRANSFERRED FROM THE DASD TO THE CHANNEL 
BYTES TRANSFERRED FROM DASD TO THE CACHE AND 
CHANNELS 

BYTES TRANSFERRED FROM THE DASD TO THE CACHE 


Figure 3. Subsystem Counters Report Legend for the IBM 3880 Storage Control Model 23 


Subsystem Status Report 


The Subsystem Status Report provides a record of the status within the subsystem 
at the time the report is requested. This report includes: 


e Address of the subsystem caching storage director. 


e Address of the device on which I/O was done. 


20 Cache Device Administration _ 


e Amount of subsystem storage that is CONFIGURED, AVAILABLE, OFFLINE, and 
BOUND.' 


e 40 bytes of hexadecimal data representing subsystem status as it is returned 
from the subsystem before it is interpreted. 


Figure 4is a sample Subsystem Status Report for Model 23. 


IDCAMS SYSTEM SERVICES TIME: 12:28:44 
3380 SUBSYSTEM STATUS REPORT 


SD ID X'FB! DEVICE ID X'CO' 


SUBSYSTEM STORAGE IN BYTES 


CONFIGURED 16777216 
AVAILABLE 16731840 
BOUND 0 
OFFLINE 0 


RETURNED STATUS 0-19 FBCQOQ00 OCOOFFFF FFFFO100 OQOQOOFF 4ECOQ000 


20-39 00000000 00000000 00000000 00000000 00000000 
OVERALL CACHING STATUS ACTIVE 


FOR DEVICES 00 01 02 03 04 05 06 07 08 09 OA OB OC OD OE OF 
10 11 12 13 14 15 16 17 18 19 1A 1B 1C 1D 1E IF 


SD ID X'FA' DEVICE ID X'CO! 


SUBSYSTEM STORAGE IN BYTES 


CONFIGURED 16777216 
AVAILABLE 16731840 
BOUND 0 
OFFLINE 0 


RETURNED STATUS 0-19 FACQQ000 OCOOFFFF FFFFO100 GOQO0OFF 4ECOO000 


20-39 00000000 00000000 90000000 00000000 00000000 
OVERALL CACHING STATUS ACTIVE 


FOR DEVICES 00 O01 02 03 04 05 06 07 08 09 OA OB OC OD OE OF 
10 11 12 13 14 15 16 17 18 19 1A 1B 1C 1D 1E IF 


Figure 4. Sample Subsystem Status Report for the IBM 3880 Storage Control Model 23 


The report in Figure 5 on page 22 is the corresponding legend of Figure 4. 


1 The sum of AVAILABLE, BOUN D, and OFFLINE is always less than CONFIGURED. The difference is the amount of 


storage occupied by control data and the space remaining after the storage director has allocated as many track 
slot segments as possible from the subsystem storage space which is not occupied by subsystem control data. 
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IDCAMS SYSTEM SERVICES TIME: 12:28:44 
LEGEND 


SUBSYSTEM STATUS LEGEND ee 


SD ID - ADDRESS OF THE SUBSYSTEM'S CACHING STORAGE DIRECTOR 
DEVICE ID - ADDRESS OF THE DEVICE ON WHICH THE I/0 WAS DONE 


SUBSYSTEM STORAGE IN BYTES 

CONFIGURED - THE AMOUNT OF STORAGE THAT EXISTS IN THE CACHE FOR 
THIS SUBSYSTEM 

AVAILABLE THE AMOUNT OF STORAGE THAT IS AVAILABLE FOR CACHING 

BOUND THE AMOUNT OF STORAGE THAT IS RESTRICTED TO SPECIFIC 
DATA IN THE CACHE 

OFFLINE THE AMOUNT OF STORAGE THAT IS OFFLINE BECAUSE OF A 
HOST OR SUBSYSTEM ERROR 


RETURNED STATUS - INDICATES THE UNINTERPRETED DATA RETURNED 
FROM THE SUBSYSTEM FOR A STATUS REQUEST 

OVERALL CACHING STATUS - STATES WHETHER THE CACHE IS ACTIVE, WHETHER 
THERE WAS A pereecues ERROR OR A HOST 
TERMINATION 

FOR DEVICES - SPECIFIES FOR WHICH DEVICES CACHING HAS NOT 


BEEN DEACTIVATED, WHETHER OR NOT ACTUALLY 
ATTACHED 


Figure 5. Subsystem Status Report Legend for the IBM 3880 Storage Control Model 23 


SETCACHE 
Use the SETCACHE command with the IBM 3880 Storage Control Model 23 to: 


e Make an addressed device exaciuatet) eligible or not eligible for caching 
operations. 


e Make subsystem storage available or not available to the subsystem for 
caching operations. 


Note: The SETCACHE command is protected by SAF/RACF resources, see 
“System Authorization Facility” on page 11 for further information. 


The format of the SETCACHE command is: 


Table 7. SETCACHE command format, 3880 Model 23 
SETCACHE {FILE(ddname)|VOLUME(volser) UNIT(unittype)} 


[DEVICE|SUBSYSTEM] 
[ON|OFF] 


SETCACHE can be abbreviated: SETC 
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Required Parameters 
FILE(ddname)|VOLUME(vo/ser) UNIT(unittype) 
specifies the volume of a unit within the subsystem. 


FILE(ddname) 
specifies the name of a DD statement that identifies the device type and 
volume of a unit within the subsystem. For ddname, Sepa the name of 
the DD statement identifying the device type. 


VOLUME (vo/ser) 
specifies the volume serial number of a volume within the subsystem. For 
volser, substitute the volume serial number of the volume. 


Abbreviation: VOL 


UNIT(unittype) 
specifies the unit type of the subsystem. 


Optional Parameters 
DEVICE|SUBSYSTEM 
specifies whether access to a particular device or to the entire subsystem 
cache be allowed or prohibited. 


DEVICE 
specifies that access to the cache of a particular device is allowed or 
prohibited. 


Abbreviation: DEV 


SUBSYSTEM 
specifies that access to the entire subsystem cache is allowed or 
prohibited. 


Abbreviation: SSYS or SUBSYS 


Note: RACF READ access authority to the FACILITY class resource 
STGADMIN.IDC.SETCACHE SUBSYSTEM is required to use the 
SUBSYSTEM parameter. 


ON|OFF 
specifies whether access to the cache be allowed or prohibited. 


ON 
specifies that access to the cache be allowed. 


OFF 
specifies that access to the cache be prohibited. 


Note: Setting subsystem cache on or off and setting cache for a device on 
or off are independent operations. That is, cache for individual 
devices may be set on or off whether the subsystem cache is on or 
off. However, if the subsystem cache is set off, setting cache for an 
individual device on has no effect until the subsystem cache is set 
on. 
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Examples 
You can enter the SETCACHE command by using JCL statements or by using ISMF 
panels. 


Allowing Access to the Cache for a Particular Device: Example 1 
In this example, access to the cache is allowed for a particular device. 


//SETCACHE JOB... 
//STEP1 EXEC PGM=IDCAMS 
//SETOl 0D —_-UNIT=3380,VOL=SER=VOL123,DISP=SHR 
//SYSPRINT 0D  SYSOUT=A 
//SYSIN. 0D * 

SETCACHE- 

FILE(SETO1) - 

DEVICE- 

ON 


/* 
Job control language statement: 


e SETO1 DD, which specifies a 3380 unit for which access to the cache is to be 
allowed, and specifies volume VOL123. 


The SETCACHE command parameters are: 


e FILE, which specifies SETO1 as the DD statement that allocates a 3380 unit and 
volume VOL123. 


e DEVICE, which specifies that access to a single device is affected. 


e ON, which specifies that access to the cache be allowed. 


Allowing Access to the Cache for an Entire Subsystem: Example 2 
In this example, access to the cache is allowed for an entire subsystem. 


//SETCACHE JOB... 
//STEPI EXEC PGM=IDCAMS 
//SYSPRINT OD  SYSOUT=A 
//SYSIN po 

SETCACHE- 

VOLUME (VOL002) - 

UNIT (3380) - 

SUBSYSTEM- 

ON 


ie 

The SETCACHE command parameters are: 
¢ VOLUME, which specifies volume VOLOO02. 
e UNIT, which specifies a 3380 unit. 


e SUBSYSTEM, which specifies that cache access is affected for all devices in 
the subsystem containing volume VOLOOQ2. 


~@ ON, which specifies that access to the cache is allowed. 
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Prohibiting Access to the Cache for a Particular Device: Example 3 
In this example, access to the cache is prohibited for a particular device. 


| //SETCACHE JOB 
. //STEP1 EXEC PGM=IDCAMS 


//SETOL DD —_- UNIT=3380, VOL=SER=VOL123, DISP=SHR 
//SYSPRINT DD  SYSOUT=A 
//SYSIN po 
SETCACHE- 
FILE(SETO1) - 
DEVICE- 
OFF 


Vs 
Job control language statement: 


e SETO1 DD, which specifies a 3380 unit for which the cache is to be disabled, 
and specifies volume VOL123. 


( The SETCACHE command parameters are: 


e FILE, which specifies SETO1 as the DD statement that allocates a 3380 unit and 
volume VOL123. 


e DEVICE, which specifies that cache access for a single device is affected. 


e OFF, which specifies that access to the cache be prohibited. 
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LISTDATA 


The LISTDATA command obtains information about activity within the IBM 3880 
Storage Control Model 21. You can obtain two different types of reports: 


e Subsystem Counters Report—a record of the counters within the subsystem at 
the time the report is requested. 


e Subsystem Status Report—a record of the status within the subsystem at the 
time the report is requested. 


With either type of report, you can request a legend that describes the headings 
used. 


~ A user interface has been provided specifically for non-access method services 
callers (for example, the Cache RMF Reporter). This interface allows you to obtain 
subsystem status or count information. The description of the interface is in 
Appendix B, “User Access to Subsystem Status and Counts Information” on 

page 6/7. 


Note: The LISTDATA command is protected by SAF/RACF resources, see “System 
Authorization Facility” on page 11 for further information. 


The format of the LISTDATA command is: 


Table 8. LISTDATA command format, 3880 Model 21 


LISTDATA {COUNTS|STATUS} 
{FILE(ddname)|VOLUME (vo/ser) UNIT(unittype)} 
[DEVICE|SUBSYSTEM|ALL] 
[LEGEND|NOLEGEND ] 
[OUTFILE(ddname)|OUTDATASET(dsname)] 


LISTDATA can be abbreviated: LDATA 


Required Parameters 
COUNTS|STATUS 
specifies the type of report. 


COUNTS 
specifies that a subsystem counters report be printed. 


Abbreviation: CNT 


STATUS 
specifies that a subsystem status report be printed. 


Abbreviation: STAT 
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FILE(ddname)|VOLUME(vo/ser) UNIT(unittype) 
specifies a device that resides in the subsystem for which the report is 
requested. 


FILE(ddname) 
specifies the name of a DD statement that identifies the unit and volume of 
a device within the subsystem. For ddname, substitute the name of the DD 
statement identifying the device type and volume serial number. 


VOLUME (vo/ser) 
specifies the volume serial number of a volume within the subsystem. For 
volser, substitute the volume serial number of the volume. 


Abbreviation: VOL 


UNIT(unittype) 
specifies the unit type of the subsystem. This parameter is required only 
when the VOLUME parameter is specified. 


Optional Parameters 
DEVICE|SUBSYSTEM|ALL 

specifies the subsystem counters to be reported in the subsystem counters 

report. These parameters can be specified only when the COUNTS parameter 

is specified. 

DEVICE 
specifies that the subsystem counters for the addressed device are 
included in the subsystem counters report. 


Abbreviation: DEV 


SUBSYSTEM | 
specifies that the subsystem counters for all devices within the subsystem 


are included in the subsystem counters report. 
Abbreviation: SSYS or SUBSYS 


ALL 7 
specifies that the subsystem counters for all devices on all like models of 
storage controls be included in the subsystem counters report. ALL is the 
default parameter when the COUNTS parameter is specified. 


LE GEND|NOLEGEND 
specifies whether a legend explaining the headings used is printed following 
the report. 


LEGEND 
specifies that the legend is printed. This is the default parameter. 


Abbreviation: LGND 


NOLEGEND 
specifies that the legend is not printed. 


Abbreviation: NOLGND 


OUTFILE(ddname)|OUTDATASET(dsname) 
specifies an alternate target data set if the SYSPRINT data set is not used for 


the report. 


28 Cache Device Administration 


OUTFILE(ddname) 
Be specifies the name of a DD statement identifying the data set to be used to 
( contain the report. For ddname, substitute the name of the DD statement 
: identifying the data set. 


Abbreviation: OFILE 


_ OUTDATASET(dsname) 
specifies the name of the alternate target data set. OUTDATASET can be 
specified only in MVS systems. For dsname, substitute the name of the 
data set to be used. The data set name must be cataloged. 


Note: Be sure to erase the previous alternate target data set before 
specifying the OUTDATASET parameter. If you do not erase the old 
data set, your reports may not be accurate. If a report seems to be. 
in error, compare the. time field with the time the job was submitted. 


Abbreviation: ODS or OUTDS 


Examples 


Listing Subsystem Counters for a Particular Device: Example 1 
In this example, a Subsystem Counters Report for a particular device is being 
requested. 


//LISTDATL JOB... 
//STEP1 EXEC PGM=IDCAMS 
//LISTVOL1 DD — UNIT=3350,VOL=SER=VOL123,DISP=SHR 
//SYSPRINT DD  SYSOUT=A 
-_ //SYSIN OD * 
( LISTDATA- 
COUNTS- 
FILE(LISTVOL1)- 
DEVICE 


ha 
Job control language statement: 


e LISTVOL1 DD, which specifies a 3350 unit and volume VOL123 for which the 
report is requested. 


. cad The LISTDATA command parameters are: 
e COUNTS, which specifies that a Subsystem Counters Report be printed. 


e FILE, which specifies LISTVOL1 as the DD statement that allocates a 3350 unit 
and volume VOL123. | 


e DEVICE, which specifies that the Subsystem Counters Report should include 
only subsystem counters for the addressed device. 


See “Reports” on page 31, for an example of a printed Subsystem Counters 
Report. 
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Listing Subsystem Counters for All Devices within a Subsystem: Example 2 
In this example, a Subsystem Counters Report is being requested for all devices 
within a subsystem. 


//LISTDAT2 JOB... 
//STEP1 EXEC PGM=IDCAMS 
//OUTDD DD —_— DSN=OUTDS,DISP=(NEW,KEEP) , VOL=SER=OUTVOL, 
UNIT=3480, DCB=(RECFM=VBA, LRECL=125, BLKSIZE=629) 

//SYSPRINT DD  SYSOUT=A 
//SYSIN DD * 

LISTDATA- 

COUNTS- 

VOLUME (VOL002) - 

UNIT (3350) - 

SUBSYSTEM- 

OUTFILE(QUTDD) 


7? 
Job control language statement: 


e OUTDD DD, which allocates the output data set (DSN =OUTDS) on tape 
(UNIT =3480) for use by the LISTDATA command. If you do not allocate an 
output data set, the subsystem counters are printed on the SYSPRINT data set. 
The DCB parameter is required for the alternate output data set if it is new. 


The LISTDATA command parameters are: 
e COUNTS, which specifies that a Subsystem Counters Report is printed. 
e VOLUME, which specifies volume VOLOO2. 
e UNIT, which specifies a 3350 unit. 


e SUBSYSTEM, which specifies that the Subsystem Counters Report should 
include counters for all devices within this subsystem. 


e OUTFILE, which specifies OUTDD as the name of the DD statement identifying 
the data set used to contain the report. 


See “Reports” on page 31, for an example of a printed Subsystem Counters 
Report. 


Listing Subsystem Counters for All Devices on All Like Subsystems: Example 3 
In this example, a Subsystem Counters Report is being requested for all devices on 
all like subsystems. 


//LISTDAT3 JOB 
//STEP1 EXEC PGM=IDCAMS 
//OUTDS DD  DSN=OUTDATA,DISP=(,CATLG) , UNIT=3350, 
// VOL=SER=VOLO01,SPACE=(CYL, (2,1)), 
// DCB=(RECFM=VBA, 
LRECL=250, BLKSIZE=504) 

//SYSPRINT DD  SYSOUT=A 
//SYSIN Db 

LISTDATA- 

COUNTS- 

VOLUME (VOL002) - 

UNIT (3350) - 

Bits 

OUTDATASET (OUTDATA) 


hi 
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Job control language statement: 


pe -. e OUTDS DD, which allocates the output data set (DSN =OUTDATA) on a 3350 
( (UNIT =3350) for use by the LISTDATA command. If an output data set is not 
allocated, the report is printed on the SYSPRINT data set. The DCB parameter 
is required for the alternate output data set. The output data set is cataloged in 
the master catalog (DISP =(,CATLG)). This DD statement allocates 2 cylinders 
for the output data set and, if more space is required for the report, the space 
is extended in increments of 1 cylinder. 


The LISTDATA command parameters are: 
e COUNTS, which specifies that a Subsystem Counters Report be printed. 
e VOLUME, which specifies volume VOLOO2. 
e UNIT, which specifies a 3350 unit. 


e ALL, which specifies that the Subsystem Counters Report should include 
subsystem counters for all devices on all like subsystems. 


® OUTDATASET, which identifies OUTDATA as the output data set to be used for 
the report, rather than the SYSPRINT data set. 


see “Reports,” for an example of a printed Subsystem Counters Report. 


Listing Subsystem Status: Example 4 
In this example, subsystem status report is being requested. 


//LISTDAT4 JOB... 
//STEP1 EXEC PGM=IDCAMS 
//LISTVOL2 DD UNIT=3350, VOL=SER=VOL269, DISP=SHR 
//SYSPRINT DD  SYSOUT=A 
//SYSIN OD * 
LISTDATA- 
STATUS- 
FILE(LISTVOL2) 


| i 
_ Job control language statement: 
ie e LISTVOL2 DD, which specifies a 3350 unit for which subsystem status is being 
( reported. 
The LISTDATA command parameters are: 
e STATUS, which specifies that a Subsystem Status Report be printed. 


e FILE, which specifies LISTVOL2 as the DD statement that allocates a 3350 unit 
and volume VOL269. 


Reports 
Use the LISTDATA command to list information about activity within the caching 
models of IBM storage controls. You can obtain two different types of reports: 
subsystem counters report and subsystem status report. Optionally, you can also 
obtain a legend for each report. This legend describes the headings used in the 
report. When you request a legend, it is printed at the end of the report. 
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Subsystem Counters Report | 
The Subsystem Counters Report provides a record of the counters within the 
subsystem at the time the report is requested. The counters are not reset when the 
report is taken. Figure 6 is asample Subsystem Counters Report for Model 271. 


IDCAMS SYSTEM SERVICES TIME: 11:09:14 
3350 SUBSYSTEM COUNTERS REPORT 


VOLUME 335520 DEVICE ID X'20' SD ID X'74! 


DATA TRANSFERS .» -READS.. NO DASD ACCESS 
TOTAL PAGING 0 N/A 0 
NON-SEQUENTIAL 0 0 0 
SEQUENTIAL 0 0 0 
SWAP-INS 0 0 0 
TOTAL/1000 ‘ 0 0 0 


BLOCK WRITES 
DASD UPDATES 
BLOCK DISCARDS 
BLOCK UPDATES 


Ooo © © 


VOLUME 3353820 DEVICE ID X'20' SD ID X'75! 


DATA TRANSFERS »» READS... NO DASD ACCESS 
TOTAL PAGING 0 N/A 0 
NON-SEQUENT IAL 0 0 0 
SEQUENTIAL 0 — 0 0 
SWAP-INS 0 0 0 
TOTAL/1000 0 0 0 


BLOCK WRITES 
DASD UPDATES 
BLOCK DISCARDS 
BLOCK UPDATES 


Ooo © © 


Figure 6. Sample Subsystem Counters Report for the IBM 3880 Storage Control Model 21 


The report in Figure 7 on page 33 is the corresponding legend of Figure 6. 
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IDCAMS SYSTEM SERVICES 


VOLUME 


DEVICE ID 
SD ID 


DATA TRANSFERS 
READS 
NO DASD ACCESS 
TOTAL PAGING 
NON-SEQUENTIAL 


SEQUENTIAL 


SWAP-INS 

TOTAL/1000 
BLOCK WRITES 
DASD UPDATES 
BLOCK DISCARDS 


BLOCK UPDATES 


Figure 7. Subsystem Counters Report Legend for the IBM 3880 Storage Control Model 21 


LEGEND 
SUBSYSTEM COUNTERS LEGEND 
VOLUME SERIAL NUMBER FOR WHICH THE DATA IS GATHERED 


DEVICE IDENTIFICATION 
STORAGE DIRECTOR FOR WHICH THE DATA IS GATHERED 


NUMBER OF CCW CHAINS TO THIS DEVICE WITH A READ OR 
WRITE IN IT 

NUMBER OF READ CCWS 

NUMBER OF CCW CHAINS FOR WHICH NO READS REQUIRED 
DASD ACCESS 


SET PAGING PARAMETER COMMANDS THAT WERE NOT SET 
SEQUENTIAL 

SET PAGING PARAMETER COMMANDS THAT WERE SET 
SEQUENTIAL 


SET PAGING PARAMETER COMMANDS SET FOR SWAP-IN 


TOTAL DIVIDED BY 1000 FOR EACH VERTICAL LINE ITEM 
4K BLOCKS WRITTEN FROM THE HOST 

INTERNAL COMMAND CHAINS PERFORMING CACHE TO DASD 
TRANSFERS 

BLOCKS AVAILABLE FOR REASSIGNMENT THROUGH DISCARD 
BLOCK CCWS 

4K BLOCKS WRITTEN FROM CACHE TO DASD 


Subsystem Status Report 
The Subsystem Status Report provides a record of the status within the subsystem 


at the time the report is requested. This report includes: 
e Address of the subsystem paging storage director. 


e Address of the device on which I/O was done. 


TIME: 11:09:23 


e Amount of subsystem storage that is CONFIGURED, AVAILABLE, OFFLINE, and 


PINNED.’ 


e 40 bytes of hexadecimal data representing subsystem status as it is returned 


from the subsystem before it is interpreted. 


1 The sum of AVAILABLE, PINNED, and OFFLINE is always less than CONFIGURED. The difference is the amount of 
storage occupied by control data and the space remaining after the storage director has allocated as many track 


slot segments as possible from the subsystem storage space which is not occupied by subsystem control data. 
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Figure 8 is a sample Subsystem Status Report for Mode! 21. 


“IDCAMS SYSTEM SERVICES it” | | TIME: 11:00:47 
| | 3350 | SUBSYSTEM STATUS REPORT 
SD ID X'74' DEVICE ID X'20" 
SUBSYSTEM STORAGE IN BYTES 
CONFIGURED 33554432 


AVAILABLE 33099776 
OFFLINE 0 


| PINNED 0 
RETURNED STATUS 0-19 7420008F 02000000 01F91000 90000000 oaQ00000 
20-39 99900000 aeexe000 BOG0000 GRe0000 aoQ0000 
SD ID X'75' —*DEVICE ID x'20" 
SUBSYSTEM STORAGE IN BYTES 


CONFIGURED «33554432 
AVAILABLE 33099776 
OFFLINE | | Q 
PINNED = | 9 


RETURNED STATUS 0-19 7520008F 02000000 01F91000 00000000 00000000 


20-39 99090000 00000000 00000000 00000000 00000000 — 


Figure 8. Sample Subsystem Status Report for the IBM 3880 Storage Control Model 21 
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The reportin Figure 9 is the corresponding legend of Figure 8 on page 34. 


( | | IDCAMS SYSTEM SERVICES . TIME: 11:09:10 
- LEGEND 


SUBSYSTEM STATUS LEGEND 


SD 1D - ADDRESS OF THE SUBSYSTEM'S PAGING STORAGE 
DIRECTOR 

DEVICE ID - ADDRESS OF THE DEVICE ON WHICH THE I/0 
WAS DONE 


SUBSYSTEM STORAGE IN BYTES 


CONFIGURED - STORAGE THAT EXISTS IN THE CACHE FOR THIS 
SUBSYSTEM 
| AVAILABLE STORAGE THAT IS AVAILABLE FOR PAGING 
OFFLINE STORAGE THAT IS OFFLINE AND NOT AVAILABLE 
FOR PAGING 
PINNED STORAGE UNAVAILABLE BECAUSE OF CACHE 10 DASD 
EXCEPTIONS 


RETURNED STATUS INDICATES THE UNINTERPRETED DATA RETURNED 
FROM THE SUBSYSTEM FOR A STATUS REQUEST 


Figure 9. Subsystem Status Report Legend for the IBM 3880 Storage Control Model 21 


SETCACHE 


Use the SETCACHE command with the IBM 3880 Storage Control Model 21 to: 
e Make an addressed device (actuator) eligible or not eligible for caching 
operations. : 
e Make subsystem storage available or not available to the subsystem for 
caching operations. 
e Enable or disable a storage director. 
Note: The SETCACHE command is protected by SAF/RACF resources, see 
“System Authorization Facility” on page 11 for further information. 
( The format of the SETCACHE command is: 


Table 9. SETCACHE command format, 3880 Model 21 
SETCACHE {FILE(ddname)|VOLUME(volser) UNIT(unittype)} 


{ SUBSYSTEMIDIRECTOR (1[2}} 
[ON/OFF] 


SETCACHE can be abbreviated: SETC 
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Required Parameters 3 
FILE(ddname)|VOLUME(vo/ser) UNIT(unittype) 
specifies the volume of a unit within the subystem. 


FILE(ddname) ee 
specifies the name of a DD statement that identifies the device type and 
volume of a unit within the subsystem. For ddname, substitute the name of 
the DD statement identifying the device type. © 


VOLUME (vo/ser) 
specifies the volume serial number of a volume within the subsystem. For 
vo/ser, substitute the volume serial number of the volume. 


Abbreviation: VOL 


UNIT(unittype) e 
specifies the unit type of the subsystem. This parameter is required only 
when the VOLUME parameter is specified. 


SUBSYSTEM|DIRECTOR (1)|(2) 


SUBSYSTEM 
specifies that access to the entire subsystem cache be allowed or 
prohibited. 


Abbreviation: SSYS or SUBSYS 


Note: RACF READ access authority to the FACILITY class resource 
STGADMIN.IDC.SETCACHE SUBSYSTEM is required to use the 
SUBSYSTEM parameter. oe 


DIRECTOR 
specifies whether the odd or even addressed storage director on a paging 
subsystem will be allowed to access the cache. Director 1 is the even 
address and Director 2 is the odd address. This relationship is determined 
by the labeling on the service panel. 


(1) 


specifies that storage director 1 (the even address) will be used. 


(2) 


specifies that storage director 2 (the odd address) will be used. 


Abbreviation: SD 


Warning: You use SETCACHE DIRECTOR (1)|(2) OFF to permit maintenance on 
one storage director (the one set off) while continuing paging operations on the 
other storage director. However, by setting one director off and then setting the 
other director off, you set the entire subsystem off. Turning the entire subsystem 
off (regardless of how the subsystem is turned off) might cause data to be lost and 
will probably require a re-IPL of the system. After a director has been set off, use 
SETCACHE SUBSYSTEM ON to set the director on again. If a storage director is 
offline, vary the path online to the storage director and issue a SETCACHE 
SUBSYSTEM ON. The message below indicates that the storage is offline: 


IDC316121 NO PATHS ARE AVAILABLE TO THE REQUESTED SD; TO SET ON, 
ISSUE A SETCACHE SUBSYSTEM ON. 
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Optional Parameters 
ON|OFF : 
specifies whether access to the cache be allowed or prohibited. 


ON 
specifies that access to the cache be allowed. 


OFF 
specifies that access to the cache be prohibited. 


Examples 


Allowing Access to the Cache for an Entire Subsystem: Example 1 
In this example, access to the cache is allowed for an entire subsystem. 


//SETCACHE JOB... 
//STEP1 EXEC PGM=IDCAMS 
//SYSPRINT DD  SYSOUT=A 
//SYSIN ODD * 

SETCACHE- 

VOLUME (VOL002) - 

UNIT (3350) - 

SUBSYSTEM- 

ON 


/* 

The SETCACHE command parameters are: 
e VOLUME, which specifies volume VOLOO2. 
e UNIT, which specifies a 3350 unit. 


e SUBSYSTEM, which specifies that cache access is affected for all devices in 
the subsystem containing VOLOO2. 


e ON, which specifies that access to the cache is allowed. 
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cone Access to the Cache for a Director: Example 2 | ‘ eae 
This example is valid for Model 21 only. This is an example that assumes that both 
storage directors are actively supporting paging activities when it becomes 
necessary or desirable to make Storage Directcr 1 available for concurrent 
maintenance activities while Storage Director 2 is still supporting paging mode 
activities. 


//SETCACHE JOB... 
//STEP1 EXEC PGM=IDCAMS 
//SET01 DD —_ UNIT=3350, VOL=SER=VOL123,DISP=SHR 
//SYSPRINT DD SYSOUT=A_ 
//SYSIN. DD * 
SETCACHE- 
FILE(SETO1) - 
DIRECTOR(1)- 
OFF 


is 
Job control language statement: 


e SETO1 DD, which allocates a 3350 unit and volume VOL123. 


The SETCACHE command parameters are: 


e FILE, which specifies SETO1 as the DD statement that allocates a 3350 unit and 
volume VOL123. 


e DIRECTOR(1) jdatiities the storage director for which the command is 
_ intended. 


e OFF, which specifies that access to the cache be prohibited. 


Note: Subsystem storage is made not available to a storage director that is put 
offline for concurrent maintenance. When maintenance is completed, vary 
the path online to the storage director, and then issue a SETCACHE 
SUBSYSTEM ON command. This makes the subsystem available again to 
that storage director. 
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BINDDATA 
You can use the BINDDATA command with the Model 13 to: 


e Transfer data records from DASD to cache, reserving a portion of the cache for 
those data records, and 


e Release tracks of subsystem storage, making that subsystem storage available 
to store other frequently accessed application data. 
When you use the BINDDATA command to transfer data from DASD to cache, the 


data records are retained in the cache until one of the following occurs: 


e The BINDDATA command with the TERMINATE parameter is issued. 


e An initial microcode load (IML) of the cache storage director is performed. 


e A SET SUBSYSTEM MODE command is encountered which deactivates the 
cache to the device or makes the cache not availabie to the subsystem 
storage. 


When you issue the BINDDATA command, you must specify the track 
address—upper and lower limit—in cchh format (cylinder and head number) of the 
data records to be copied. Except for defective and alternate tracks, all tracks 
within the specified range for the device are transferred to the cache. The track 
address must be valid; otherwise, command processing ends. 


Before you use the BINDDATA command, you must make sure there is enough 
subsystem storage available to accommodate the storage request. To determine 
the amount of storage available, issue the LLSTDATA command with the STATUS 
parameter to obtain a subsystem status report. If there is not enough storage 
available, the BINDDATA command processing ends. 


Before data can be bound to a volume, caching must be allowed for the volume. If 
caching is not active for the volume, a SETCACHE command can be used to allow 
caching for it. 


When you specify a range of tracks to be read into the cache and a data check 
occurs in DASD data, the track on which the error occurs is not transferred into 
cache. The BINDDATA operation continues with the next track until the operation 
is complete. No error indication is given for any tracks that are not transferred to 
the cache. 


When you use the BINDDATA command to release tracks of subsystem storage, all 
tracks within the specified track range for the addressed device are released and 
placed on the available queue as the next available space in the cache. The range 
of tracks being released does not have to coincide with a previously established 
range. A portion of an area may be released, or the specified range may overlap 
other established areas. If all established areas for an addressed device or for the 
subsystem are released, all tracks are also released. 
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Note: The BINDDATA command is protected by SAF/RACF resources, see 
“System Authorization Facility” on page 11 for further information. 


The format of the BINDDATA command is: 


Table 10. BINDDATA command format, 3880 Model 13 


BINDDATA | {ESTABLISH|TERMINATE} 
{FILE(ddname)|VOLUME (vo/ser) UNIT(unittype)} 


[DEVICE|SUBSYSTEM] 
[HIGHCCHH(cchh)] 
(LOWCCHH(cchh)] 


BINDDATA can be abbreviated: BDATA 


Required Parameters 
ESTABLISH|TERMINATE 
specifies that data will be transferred from DASD to cache, or that tracks of 
subsystem storage are to be made available for other application data. 


ESTABLISH 
specifies that data be transferred into the subsystem storage. 


Abbreviation: ESTAB, EST 


TERMINATE 


specifies that tracks of subsystem storage are to be made available for 
other application data. 


Abbreviation: TERM 


FILE(ddname)|VOLUME(voi/ser) UNIT(unittype) 
specifies a DASD volume that contains data to be read into the cache. 


FILE(ddname) 
specifies the name of a DD statement that identifies the unit and volume 
within the subsystem that contains data to be transferred to the cache. For 
ddname, substitute the name of the DD statement identifying the device. 


VOLUME (vol/ser) | 
specifies the volume serial number of a volume within the subsystem that 
contains data to be transferred to the cache. For volser, substitute the 
serial number of the volume. 


Abbreviation: VOL 


UNIT(unittype) 
specifies the unit type for a device within the subsystem that contains data 
to be transferred to the cache. This parameter is required only when the 
VOLUME parameter is specified. 


Optional Parameters 

DEVICE|SUBSYSTEM 
specifies whether data on a particular direct access storage device be 
transferred to or from the cache, or all bound data is released and subsystem 
storage be made available for other application data. When the TE RMINATE » 
parameter is Svea the SUBSYSTEM parameter is the default. 
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DEVICE 
specifies that data on a particular direct access storage device be 
_ transferred to cache, or be made available for other application data. 


Abbreviation: DEV 


SUBSYSTEM 
specifies that the entire subsystem storage be released and made 
available for other application data. 


Abbreviation: SSYS or SUBSYS 


LOWCCHH(cchh) 
specifies the track address of the lower limit of a series of tracks containing 
data that is to be transferred to the cache or that is to be made available for 
other application data. 


cchh 
specifies the address in the format cylinder head as an 8-digit hexadecimal 
number. The first 4 digits are the cylinder portion of the address, and the 
second 4 digits are the head or track portion of the address. 


Abbreviation: LCCHH 


HIGHCCHH(cchh) 
specifies the track address of the upper limit of a series of tracks that contain 
_ data that is to be transferred to the cache or that is to be made available for 
other application data. 


cchh 
specifies the address in the format cylinder head as an 8-digit hexadecimal 
number. The first 4 digits are the cylinder portion of the address, and the 
second 4 digits are the head or track portion of the address. The maximum 
values that can be specified for a 3380 device are returned from an 
invocation of DEVTYPE. 


Abbreviation: HCCHH 


Example 
| In this example, the first extent of a data set on a 3380 direct access storage device 
attached to a 3880 Model 13 is read into cache. 


Binding a Range of Data: Example 1 
In this example, the first extent of a data set is bound: 


//BINDATL JOB... 
//STEP1 EXEC PGM=IDCAMS 
//BIND01 0D — UNIT=3380,VOL=SER=VOL123,DISP=SHR 
//SYSPRINT DD  SYSOUT=A 
//SYSIN DD * 
BINDDATA- 
ESTABLISH- 
FILE(BINDO1) - 
LOWCCHH (00010001) - 
HIGHCCHH (00010002) 


/* 
Job control language statements: 


e BINDO1 DD, which specifies a 3380 unit and volume VOL123. 
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ane BINDDATA command parameters are: 
e ESTABLISH, which specifi es that data be transferred to the cache. 


e FILE, which specifies BINDO1 as the DD statement that identifies volume 
VOL123 on a 3380 direct access storage device from which the data is to be 
transferred. 3 


e LOWCCHhH, which specifies the track address of the lower limit CCHH to be 
transferred to the cache. 


om HiGHCCHH, which specifies the track address of the higher limit CCHH to be 
transferred to the cache. 


LISTDATA 


The LISTDATA command obtains information about activity within the IBM 3880 
Storage Control Model 13. You can obtain two different types of reports: 


e Subsystem Counters Report—a record of the counters within the subsystem at 
the time the report is requested. 


e Subsystem Status Report—a record of the status within the subsystem at the 
time the report is requested. 


With either type of report, you can request a legend that describes the headings 
used. | 


A user interface has been provided specifically for non-access method services 
callers (for example, the Cache RMF Reporter). This interface allows you to obtain 
subsystem status or count information. The description of the interface is in 
Appendix B, “User Access to Subsystem Status and Counts Information” on 

page 67. 


Note: The LISTDATA command is protected by SAF/RACF resources, see “System 
Authorization Facility” on page 11 for further information. 


The format of the LISTDATA command is: 


Table 11. LISTDATA command format, 3880 Model 13 | 


LISTDATA {COUNTS|STATUS} 

| {FILE(ddname)| VOLUME (volser) UNIT(unittype)} 
_ (DEVICE|SUBSYSTEM|ALL] 

_ [LEGEND|NOLEGEND] 

PORTER (Geneine) OU TD ANASEN(dsnaine) 
[WTO] 


LISTDATA can be abbreviated: LDATA 


Required Parameters 
COUNTS|STATUS 
| specifies the type of report. 


COUNTS 
specifies that a subsystem counters report be printed. 


Abbreviation: CNT 
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STATUS 
specifies that a subsystem status report be printed. 


Abbreviation: STAT 


FILE(ddname)|VOLUME(volser) UNIT(unittype) 

specifies a device that resides in the subsystem for which the report is 

requested. 

FILE(ddname) 
specifies the name of a DD statement that identifies the unit and volume of 
a device within the subsystem. For ddname, substitute the name of the DD 
statement identifying the device type and volume serial number. 

VOLUME (vo/ser) 
specifies the volume serial number of a volume within the subsystem. For 
volser, substitute the volume serial number of the volume. 
Abbreviation: VOL 


UNIT(unittype) 
specifies the unit type of the subsystem. This parameter is required only 
when the VOLUME parameter is specified. 


Optional Parameters 
DEVICE|SUBSYSTEM|ALL | 
specifies the subsystem counters to be reported in the subsystem counters 
report. These parameters can be specified only wet the COUNTS parameter | 
is specified. 
DEVICE 
specifies that the subsystem counters for the addressed device are 
included in the subsystem counters report. 
Abbreviation: DEV 


SUBSYSTEM 
specifies that the subsystem counters for all devices within the subsystem 
are included in the subsystem counters report. 


Abbreviation: SSYS or SUBSYS 


ALL 
abeciniast that subsystem counters for all devices on all like models of 
storage controls be included in the subsystem counters report. ALL is the 
default parameter when the COUNTS parameter is specified. 


LE GEND|NOLEGEND 


specifies whether a legend explaining the headings used is printed following 
the requested report. 


LEGEND : 
specifies that the legend is printed. 


Abbreviation: LGND 


NOLEGEND 
specifies that the legend is not printed. This is the default parameter. 


Abbreviation: NOLGND 
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OUTFILE(ddname)|OUTDATASET(dsname) 
specifies an alternate target data set if the SYSPRINT data set is not used for 
the report. — 


~ OUTFILE(ddname) 
specifies the name of a DD statement identifying the data set to be used to 
contain the report. For ddname, substitute the name of the DD statement 
identifying the data set. 


Abbreviation: OFILE 


OUTDATASET(dsname) 
specifies the name of the alternate target data set. For dsname, substitute 


the name of the data set to be used. The data set name must be cataloged. 


Note: Be sure to erase the previous alternate target data set before 
specifying the OUTDATASET parameter. If you do not erase the old 
data set, your reports may not be accurate. If a report seems to be 


in error, compare the time field with the time the job was submitted. 


Abbreviation: ODS or OUTDS 


WTO 
specifies that information on the overall condition of the subsystem be sent to 
the system console and a full report printed. 


Abbreviation: None 


Note: This parameter can be used only if the STATUS parameter is specified. 


Examples 


Listing Subsystem Counters for a Particular Device: Example 1 
In this example, a Subsystem Counters Report for a particular device is being 
requested. 


//LISTDATL JOB... 
//STEP1 EXEC PGM=IDCAMS 
//LISTVOL1 DD — UNIT=3380,VOL=SER=VOL123,DISP=SHR 
//SYSPRINT DD  SYSOUT=A 
//SYSIN OD * 
LISTDATA- 
COUNTS- 
FILE(LISTVOL1)- 
DEVICE 


/* 
Job control language statement: 


e LISTVOL1 DD, which specifies a 3380 unit and volume VOL123 for which the 
report is requested. 
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The LISTDATA command parameters are: 
( e COUNTS, which specifies that a Subsystem Counters Report be printed. 


e FILE, which specifies LISTVOL1 as the DD statement that allocates a 3380 unit 
and volume VOL123. 


e DEVICE, which specifies that the Subsystem Counters Report should include 
only subsystem counters for the addressed device. 


a See “Reports” on page 47, for an example of a printed Subsystem Counters 


Report. 


Listing Subsystem Counters for All Devices within a Subsystem: Example 2 
In this example, a Subsystem Counters Report is being requested for all devices 
within a subsystem. 


//LISTDAT2 JOB... 
//STEP1 EXEC PGM=IDCAMS 
//OUTDD DD — DSN=OUTDS,DISP=(NEW,KEEP) , VOL=SER=OUTVOL, 
UNIT=3480 , DCB=(RECFM=VBA, LRECL=125, BLKSIZE=629) 
//SYSPRINT DD  SYSQUT=A 
//SYSIN 0D * 
LISTDATA- 
COUNTS- 
VOLUME (VOL062) - 
UNIT (3380) - 
SUBSYSTEM- 
OUTFILE (OUTDD) 


As 
Job control language statement: 


e OUTDD DD, which allocates the output data set (DSN =OUTDS) on tape 
(UNIT =3480) for use by the LISTDATA command. If you do not allocate an 
output data set, the subsystem counters are printed on the SYSPRINT data set. 
The DCB parameter is required for the alternate output data set if it is new. 


The LISTDATA command parameters are: 
e COUNTS, which specifies that a Subsystem Counters Report is printed. 
e VOLUME, which specifies volume VOLO02. 
e UNIT, which specifies a 3380 unit. 


e SUBSYSTEM, which specifies that the Subsystem Counters Report should 
t include counters for all devices within this subsystem. 


e QOUTFILE, which specifies OUTDD as the name of the DD statement identifying 
the data set used to contain the report. 


See “Reports” on page 47, for an example of a printed Subsystem Counters 
Report. 
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Listing Subsystem Counters for All Devices on All Like Subsystems: Example 3 
In this example, a Subsystem Counters Report is being requested for all devices on 
all like subsystems. | 


//LISTDAT3 JOB... 
//STEP1 EXEC PGM=IDCAMS | | 
//OUTDS DD — DSN=OUTDATA,DISP=(,CATLG) , UNIT=3380, 
// VOL=SER=VOL001, SPACE=(CYL, (2,1)), 
// DCB=(RECFM=VBA, 
// LRECL=250, BLKSIZE=504) 
//SYSPRINT DD  SYSOUT=A 
//SYSIN. DD * 3 

LISTDATA- 

COUNTS- | 

VOLUME (VOL002) - 

UNIT (3380) - 
ALL- 
OQUTDATASET (OUTDATA) 


j* 
Job control language statement: 


¢ QOUTDS DD, which allocates the output data set (DSN =OUTDATA) on a 3380 
(UNIT =3380) for use by the LISTDATA command. If an output data set is not 
allocated, the report is printed on the SYSPRINT data set. The DCB parameter 
is required for the alternate output data set. The output data set is cataloged in 
the master catalog (DISP =(,CATLG)). This DD statement allocates 2 cylinders 
for the output data set and, if more space is required for the report, the space 
is extended in increments of 1 cylinder. | 


The LISTDATA command parameters are: 
e COUNTS, which specifies that a Subsystem Counters Report be printed. 
e VOLUME, which specifies volume VOLOO2. 
e UNIT, which specifies a 3380 unit. 


e ALL, which specifies that the Subsystem Counters Report should include 
subsystem counters for all devices on all like subsystems. 


e OUTDATASET, which identifies OUTDATA as the output data set to be used for 
the report, rather than the SYSPRINT data set. 


See “Reports” on page 47, for an example of a printed Subsystem Counters 
Report. 


Listing Subsystem Status: Example 4 
In this example, subsystem status report is being requested. 


//LISTDAT4 JOB... 
//STEP1 EXEC PGM=IDCAMS 
//LISTVOL2 DD — UNIT=3380, VOL=SER=VOL269, DISP=SHR 
//SYSPRINT DD — SYSOUT=A 
//SYSIN DD * 

LISTDATA- 

STATUS- 

FILE(LISTVOL2) - 

WTO 


Vie 
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~ Job control language statement: 


e LISTVOL2 DD, which specifies a 3380 unit for which subsystem status is being 
reported. 


The LISTDATA command parameters are: 
e STATUS, which specifies that a Subsystem Status Report be printed. 


e FILE, which specifies LISTVOL2 as the DD statement that allocates a 3380 unit 
and volume VOL269. 


e WTO which specifies that an informational message indicating the status of 
subsystem caching activity will be displayed on the system console. For 
example, WTO may produce a message similar to the one below: 


IDC015511 3380 CACHING STATUS: SYSTEM AVAILABLE FOR SD X'Q5' DEV ID X'@1' 


Reports 
Use the LISTDATA command to list information about activity within the 3880 Model 
13. You can obtain two different types of reports: 


e Subsystem counters report and 
e Subsystem status report. 


Optionally, you can also obtain a legend for each report. This legend describes the 
headings used in the report. When you request a legend, it is printed at the end of 
the report. 


Subsystem Counters Report 
The Subsystem Counters Report provides a record of the counters within the 
subsystem at the time the report is requested. The counters are not reset when the 
report is taken. Figure 10 on page 48 is a sample Subsystem Counters Report for 
Model 13. 
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IDCAMS SYSTEM SERVICES TIME: 11:56222- 
3380 SUBSYSTEM COUNTERS REPORT 


VOLUME 338RFO DEVICE ID X'13' 


CHANNEL COMMAND CHAINS 


veeeSEARCH/READ.....05 00 vee aeee WRITE... cece eee 

REQUESTS SD ID SUBTOTAL CACHE READ SUBTOTAL CACHE WRITE 
NORMAL X'13! 27 22 14 12 
X'12! 24 23 15 13 

SEQUENTIAL X'13! 2 1 1 N/A 
X'12! 1 1 0 N/A 

TOTAL/1000 0 9 9 Q 


BOUND TRACK SD ID READ TOTAL WRITE TOTAL 


AY TS" 0 0 
X'12! 0 0 
INHIBIT CACHE LOADING REQUESTS. SD ID X'13! 0 
X'12! 0 
DASD TO CACHE XFERS, INTERNAL COMMAND CHAINS. SD ID X'13' 68 


X'12' 86 


CONTROL UNIT DATA TRANSFER IN BYTES 


CACHE TO CHANNEL SD ID X'13! 10092 
X12! 7602 
DASD TO CHANNEL SD: IDK  i3? 60144 
eae Wa 60480 
CACHE TO DASD S01 ID XY 13" 2112 
X'12! 1856 
DASD T0 CACHE SD ID X'13!' 1447856 
X'12! 2290472 


Figure 10. Sample Subsystem Counters Report for the IBM 3880 Storage Control Model 13 


The report in Figure 11 on page 49 is the corresponding legend of Figure 10. 
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IDCAMS SYSTEM SERVICES TIME: 11:56:22 


( a LEGEND 
| we 


SUBSYSTEM COUNTERS LEGEND 


VOLUME - VOLUME SERIAL NUMBER FOR WHICH THE DATA IS GATHERED 
DEVICE ID - DEVICE IDENTIFICATION 
SD 1D - STORAGE DIRECTOR FOR WHICH DATA IS GATHERED 


CHANNEL COMMAND CHAINS - A CCW CHAIN WHICH CONTAINS AT LEAST ONE 

SEARCH, READ OR WRITE 

SEARCH/READ  - CCW CHAINS WHICH CONTAIN AT LEAST ONE SEARCH OR 
READ BUT NO WRITE CCW 

WRITE - CCW CHAINS CONTAINING AT LEAST ONE WRITE 

SUBTOTAL - ALL SEARCH/READ CCW CHAINS 

CACHE READS - CCW CHAINS WHICH REQUIRED NO DATA TO BE MOVED 
TO/FROM THE DASD 

SUBTOTAL - ALL WRITE CCW CHAINS 

CACHE WRITES - CHAINS NOT REQUIRING DATA MOVEMENT TO THE CACHE 
FROM THE DASD. THIS DATA IS NOT KEPT FOR SEQUENTIAL 


NORMAL - CCW CHAINS WHICH DO NOT INCLUDE A DEFINE EXTENT CCW 
OR SPECIFY NORMAL CACHE REPLACEMENT IN THE DEFINE 
EXTENT CCW 

SEQUENTIAL - CCW CHAINS WHICH SPECIFY SEQUENTIAL ACCESS IN THE 
DEFINE EXTENT CCW 

TOTAL/1000 - TOTAL DIVIDED BY 1000 FOR EACH VERTICAL LINE ITEM 

BOUND TRACK - CCW CHAINS WHICH SPECIFY A TRACK PREVIOUSLY BOUND BY 


INHIBIT CACHE LOADING - CCW CHAINS WHICH SPECIFY INHIBIT CACHE LOADING 
IN THE DEFINE EXTENT CCW 

DASD TO CACHE TRANSFERS - THE NUMBER OF INTERNAL COMMAND CHAINS WHICH 
MOVE DATA FROM THE DASD TO THE CACHE 


CONTROL UNIT DATA TRANSFER IN BYTES 


CACHE/CHAN - BYTES TRANSFERRED FROM CACHE TO THE CHANNEL 

DASD/CHAN - BYTES TRANSFERRED FROM THE DASD TO THE CHANNEL 

CACHE/DASD - BYTES TRANSFERRED FROM CACHE TO DASD. THIS ALSO . 
REPRESENTS CHANNEL TO CACHE 

DASD /CACHE - BYTES TRANSFERRED FROM THE DASD TO THE CACHE 


Figure 11. Subsystem Counters Report Legend for the IBM 3880 Storage Control Model 13 


Subsystem Status Report 
The Subsystem Status Report provides a record of the status within the subsystem 
at the time the report is requested. This report includes: 


e Address of the subsystem caching storage director. 


e Address of the device on which |/O was done. 
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e Amount of subsystem storage that is CONFIGURED, AVAILABLE, OFFLINE, and 
BOUND.' | 


e 40 bytes of hexadecimal data representing subsystem status as it is returned 
from the subsystem before it is interpreted. 


Figure 12 is a sample Subsystem Status Report for Model 13. 


IDCAMS SYSTEM SERVICES | TIME: 11:55:54 


3380 SUBSYSTEM STATUS REPORT 


SD ID X'12! DEVICE ID X'13' 


SUBSYSTEM STORAGE IN BYTES 
CONFIGURED 4194304 
AVAILABLE 2690240 
BOUND 1489240 
OFFLINE 0 
RETURNED STATUS 0-19 12130000 00000000 FFFFO040 00000029 OCCO0016 


20-39 B9580000 00000000 00000000 90000000 00000000 
OVERALL CACHING STATUS ACTIVE 


FOR DEVICES 00 01 02 03 04 05 06 07 08 09 OA OB OC OD OE OF 
10 11 12 13 14 15 16 17 18 19 1A 1B 1¢ 1D 1E 1F 


Figure 12. Sample Subsystem Status Report for the IBM 3880 Storage Control Model 13 


1 The sum of AVAILABLE, BOUND, and OFFLINE is always less than CONFIGURED. The difference is the amount of : 
storage occupied by control data and the space remaining after the storage director has allocated as many track 
slot segments as possible from the subsystem storage space which is not occupied by subsystem control data. 
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The report in Figure 13 is the corresponding legend of Figure 12 on page 50. 


{ 2 IDCAMS SYSTEM SERVICES TIME: 11:56:17 


LEGEND 


SUBSYSTEM STATUS LEGEND 


SD ID - ADDRESS OF THE SUBSYSTEM'S CACHING STORAGE DIRECTOR 
DEVICE ID - ADDRESS OF THE DEVICE ON WHICH THE I/O WAS DONE 


SUBSYSTEM STORAGE IN BYTES 

CONFIGURED - THE AMOUNT OF STORAGE THAT EXISTS IN THE CACHE FOR 
THIS SUBSYSTEM 

AVAILABLE THE AMOUNT OF STORAGE THAT IS AVAILABLE FOR CACHING 

BOUND THE AMOUNT OF STORAGE THAT IS RESTRICTED TO SPECIFIC 

| DATA IN THE CACHE 

OFFLINE THE AMOUNT OF STORAGE THAT IS OFFLINE BECAUSE OF A 

HOST OR SUBSYSTEM ERROR 


RETURNED STATUS - INDICATES THE UNINTERPRETED DATA RETURNED FROM THE 
SUBSYSTEM FOR A STATUS REQUEST 


OVERALL CACHING STATUS - STATES WHETHER THE CACHE IS ACTIVE, WHETHER 
THERE WAS A SUBSYSTEM ERROR OR A HOST 
TERMINATION 


FOR DEVICES - SPECIFIES FOR WHICH DEVICES CACHING HAS NOT 
BEEN DEACTIVATED, WHETHER OR NOT ACTUALLY 
ATTACHED 


Figure 13. Subsystem Status Report Legend for the IBM 3880 Storage Control Model 13 
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SETCACHE 
Use the SETCACHE command with IBM 3880 Storage Control Model 13 to: 


e Make an addressed device (actuator) eligible or not eligible for caching 
operations. | 


e Make subsystem storage available or not available to the subsystem for 
caching operations. 


Note: The SETCACHE command is protected by SAF/RACF resources, see 
“System Authorization Facility” on page 11 for further information. 


The format of the SETCACHE command is: 


Table 12. SETCACHE command format, 3880 Model 13 
SETCACHE | {FILE(ddname)|VOLUME(vo/ser) UNIT(unittype)} 


[DEVICE|SUBSYSTEM] 
[ON|OFF] 


SETCACHE can be abbreviated: SETC 


Required Parameters 
FILE(ddname)|VOLUME(volser) UNIT(unittype) 
specifies the volume of a unit within the subsystem. 


FILE(ddname) 
specifies the name of a DD statement that identifies the device type and 
volume of a unit within the subsystem. For ddname, substitute the name of 
the DD statement identifying the device type. 


VOLUME (vo/ser) 
specifies the volume serial number of a volume within the subsystem. For 
volser, substitute the volume serial number of the volume. 


Abbreviation: VOL 


UNIT (unittype) 
specifies the unit type of the subsystem. 


Optional Parameters 
DEVICE|SUBSYSTEM 
specifies whether access to a particular device or to the entire subsystem 
cache be allowed or prohibited. 


DEVICE 
specifies that access to the cache of a particular device is allowed or 
prohibited. 


Abbreviation: DEV 


SUBSYSTEM 
specifies that access to the entire subsystem cache is allowed or 
prohibited. | | 


Abbreviation: SSYS or SUBSYS 
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Note: RACF READ access authority to the FACILITY class resource 
STGADMIN.IDC.SETCACHE .SUBSYSTEM is required to use the 
1 eh | SUBSYSTEM parameter. 


ON|OFF 
specifies whether access to the cache be allowed or prohibited. 


ON 
specifies that access to the cache be allowed. 


OFF 
specifies that access to the cache be prohibited. 


Note: Setting subsystem cache on or off and setting cache for a device on 
or off are independent operations. That is, cache for individual 
devices may be set on or off whether the subsystem cache is on or 
off. However, if the subsystem cache is set off, setting cache for an 
individual device on has no effect until the subsystem cache is set 
on. 


en 
LSE, 
’ et 


Examples 
You can enter the SETCACHE command by using JCL statements or by using ISMF 
panels. 


Allowing Access to the Cache for a Particular Device: Example 1 
In this example, access to the cache is allowed for a particular device. 


//SETCACHE JOB... 
//STEP1 EXEC PGM=IDCAMS 
//SETOL DD —_— UNIT=3380, VOL=SER=VOL123,DISP=SHR 
//SYSPRINT DD  SYSOUT=A 
//SYSIN DD * 

SETCACHE- 

FILE(SETO1) - 

DEVICE- 

ON 


/* 
Job control language statement: 


e SETO1 DD, which specifies a 3380 unit for which access to the cache is to be 
allowed, and specifies volume VOL123. 


The SETCACHE command parameters are: 


e FILE, which specifies SETO1 as the DD statement that allocates a 3380 unit and 
volume VOL123. 


e DEVICE, which specifies that access to a single device is affected. 


e ON, which specifies that access to the cache be allowed. 
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Allowing Access to the Cache for an Entire Subsystem: Example 2 | 
In this example, access to the cache is allowed for an entire subsystem. 


//SETCACHE JOB 
//STEP1 EXEC PGM=IDCAMS 
//SYSPRINT DD  SYSOUT=A 
//SYSIN DD * 
SETCACHE- 
VOLUME (VOL002) - 
UNIT (3380) - 
SUBSYSTEM- 
ON 


i? 

The SETCACHE command parameters are: 
© VOLUME, which specifies volume VOLOO2. 
e UNIT, which specifies a 3380 unit. 


e SUBSYSTEM, which specifies that cache access is affected for all devices in 
the subsystem containing volume VOLOO2. 


e ON, which specifies that access to the cache is allowed. 


Prohibiting Access to the Cache for a Particular Device: Example 3 
In this example, access to the cache is prohibited for a particular device. 


//SETCACHE JOB... 
//STEP1 EXEC PGM=IDCAMS 
//SETO1 DD _—_— UNI T=3380, VOL=SER=V0L123,DISP=SHR 
//SYSPRINT DD  SYSOUT=A 
//SYSIN DD * 

SETCACHE- 

FILE(SETO1) - 

DEVICE- 

OFF 


/* 
Job contro! language statement: 
e SETO1 DD, which specifies a 3380 unit for which the cache is to be disabled, 
and specifies volume VOL123. 
The SETCACHE command parameters are: 


e FILE, which specifies SETO1 as the DD statement that allocates a 3380 unit and 
volume VOL123. 


e DEVICE, which specifies that cache access for a single device is affected. 


e OFF, which specifies that access to the cache be prohibited. 
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LISTDATA 


The LISTDATA command obtains information about activity within the IBM 3880 
Storage Control Model 11. You can obtain two different types of reports: 


e Subsystem Counters Report—a record of the counters within the subsystem at 
the time the report is requested. 


e Subsystem Status Report—a record of the status within the subsystem at the 
time the report is requested. 


With either type of report, you can request a legend that describes the headings 
used. 


A user interface has been provided specifically for non-access method services 
callers (for example, the Cache RMF Reporter). This interface allows you to obtain 
subsystem status or count information. The description of the interface is in 
Appendix B, “User Access to Subsystem Status and Counts Information” on _ 
page 67. 


Note: The LISTDATA command is protected by SAF/RACF resources, see “System 
Authorization Facility” on page 11 for further information. 


The format of the LISTDATA command is: 


Table 13. LISTDATA command format, 3880 Model 11 


LISTDATA | {COUNTS|STATUS} 
{FILE(ddname)|VOLUME(volser) UNIT(unittype)} 
[DEVICE|SUBSYSTEM|ALL] 
[LEGEND|NOLEGEND] 
[OUTFILE(ddname)|OUTDATASET(dsname)] 


LISTDATA can be abbreviated: LDATA 


Required Parameters | 
COUNTS|STATUS 
specifies the type of report. 


COUNTS 
specifies that a subsystem counters report be printed. 


Abbreviation: CNT 


STATUS 
specifies that a subsystem status report be printed. 


Abbreviation: STAT 


FILE(ddname)|VOLUME(volser) UNIT(unittype) 
specifies a device that resides in the subsystem for which the report is 
requested. 
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FILE(ddname) | 
specifies the name of a DD statement that identifies the unit and volume of 
a device within the subsystem. For ddname, substitute the name of the DD 
statement identifying the device type and volume serial number. 


VOLUME (vo/ser) 
specifies the volume serial number of a volume within the subsystem. For 
volser, substitute the volume serial number of the volume. 


Abbreviation: VOL 


UNIT(unittype) 
specifies the unit type of the subsystem. This parameter is required only 
when the VOLUME parameter is specified. 


Optional Parameters 
DEVICE|SUBSYSTEM|ALL 
specifies the subsystem counters to be reported in the subsystem counters 
report. These parameters can be specified only when the COUNTS parameter | 
is specified. 


DEVICE 
specifies that the subsystem counters for the addressed device are 
included in the subsystem counters report. 


Abbreviation: DEV 


SUBSYSTEM 
specifies that the subsystem counters for all devices within the subsystem 
are included in the subsystem counters report. 


Abbreviation: SSYS or SUBSYS 


ALL 
specifies that subsystem counters for all devices on all like models of 
storage controls be included in the subsystem counters report. ALL is the 
default parameter when the COUNTS parameter is specified. 


LEGEND|NOLEGEND 
specifies whether a legend explaining the headings used is printed following 
the requested report. 


LEGEND | 
specifies that the legend is printed. 


Abbreviation: LGND 


NOLEGEND 
specifies that the legend is not printed. This is the default parameter. 


Abbreviation: NOLGND 


OUTFILE(ddname)|OUTDATASET(dsname) 
specifies an alternate target data set if the SYSPRINT data set is not to be used 
for the report. 


OUTFILE(ddname) 

| specifies the name of a DD statement identifying the data set to be used to 
contain the report. For ddname, substitute the name of the DD statement 
identifying the data set. 


Abbreviation: OFILE 
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OUTDATASET(dsname) 
specifies the name of the alternate target data set. For dsname, substitute 
the name of the data set to be used. The data set name must be cataloged. 


Note: Be sure to erase the previous alternate target data set before 
specifying the OUTDATASET parameter. If you do not erase the old 
data set, your reports may not be accurate. If a report seems to be 
in error, compare the time field with the time the job was submitted. 


Abbreviation: ODS or OUTDS 


Examples 


Listing Subsystem Counters for a Particular Device: Example 1 
In this example, a Subsystem Counters Report for a particular device is being 
requested. 


//LISTDAT1 JOB 
//STEPL ‘EXEC PGM=IDCAMS 
//LISTVOL1 DD UNI T=3350, VOL=SER=VOL123,DISP=SHR 
//SYSPRINT DD  SYSOUT=A 
//SYSIN. 0D * 
LISTDATA- 
COUNTS- 
FILE(LISTVOL1) - 
DEVICE 


Yb 
Job control language statement: 
e LISTVOL1 DD, which specifies a 3350 unit and volume VOL123 for which the 
report is requested. 
The LISTDATA command parameters are: 
e COUNTS, which specifies that a Subsystem Counters Report be printed. 


e FILE, which specifies LISTVOL1 as the DD statement that allocates a 3350 unit 
and volume VOL123. 


e DEVICE, which specifies that the Subsystem Counters Report should include 
only subsystem counters for the addressed device. 


See “Reports” on page 61, for an example of a printed Subsystem Counters 
Report. 
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Listing Subsystem Counters for All Devices within a Subsystem: Example 2 
In this example, a Subsystem Counters Report is being requested for all devices 
within a subsystem. 


//LISTDAT2 JOB 


//STEP1 EXEC PGM=IDCAMS 
//OUTDD DD —_- DSN=OUTDS,DISP=(NEW, KEEP) , VOL=SER=OUTVOL, 


UNI T=3480 , DCB=(RECFM=VBA, LRECL=125, BLKSIZE=629) 


//SYSPRINT DD  SYSOUT=A 
//SYSIN DD * 


J* 


LISTDATA- 


COUNTS- 
VOLUME (VOL0@2) - 
UNIT (3350) - 
SUBSYSTEM- 
OUTFILE (OUTDD) 


Job control language statement: 


OUTDD DD, which allocates the output data set (DSN =OUTDS) on tape 

(UNIT =3480) for use by the LISTDATA command. If you do not allocate an 
output data set, the subsystem counters are printed on the SYSPRINT data set. 
The DCB parameter is required for the alternate output data set if it is new. 


The LISTDATA command parameters are: 


COUNTS, which specifies that a Subsystem Counters Report is printed. 
VOLUME, which specifies volume VOLOO2. 
UNIT, which specifies a 3350 unit. 


SUBSYSTEM, which specifies that the Subsystem Counters Report should 
include counters for all devices within this subsystem. 


OUTFILE, which specifies OUTDD as the name of the DD statement identifying 
the data set used to contain the report. 


See “Reports” on page 61, for an example of a printed Subsystem Counters 
Report. 
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Listing Subsystem Counters for All Devices on All Like Subsystems: Example 3 
ai In this example, a Subsystem Counters Report is being requested for all devices on 
( | all like subsystems. 


//LISTDAT3 JOB... 
//STEPL EXEC PGM=IDCAMS 
//OUTDS DD —DSN=OUTDATA,DISP=(,CATLG) ,UNIT=3350, 
// VOL=SER=V0LO01,SPACE=(CYL,(2,1)), 
// DCB=(RECFM=VBA, 
LRECL=250,BLKSIZE=504) 
//SYSPRINT DD  SYSOUT=A 
//SYSIN DD * 
LISTDATA- 
COUNTS- 
VOLUME (VOL02) - 
UNIT (3350) - 
ALL- 
OUTDATASET (OUTDATA) 


hi 
Job control language statement: 


e OUTDS DD, which allocates the output data set (DSN =OUTDATA) on a 3350 
(UNIT =3350) for use by the LISTDATA command. If an output data set is not 
allocated, the report is printed on the SYSPRINT data set. The DCB parameter 
is required for the alternate output data set. The output data set is cataloged in 
the master catalog (DISP =(,CATLG)). This DD statement allocates 2 cylinders 
for the output data set and, if more space is required for the report, the space 
is extended in increments of 1 cylinder. 


The LISTDATA command parameters are: 
e COUNTS, which specifies that a Subsystem Counters Report be printed. 
e VOLUME, which specifies volume VOLOO2. 
e UNIT, which specifies a 3350 unit. 


e ALL, which specifies that the Subsystem Counters Report should include 
subsystem counters for all devices on all like subsystems. 


e OUTDATASET, which identifies OUTDATA as the output data set to be used for 
the report, rather than the SYSPRINT data set. 


See “Reports” on page 61, for an example of a printed Subsystem Counters 
Report. 
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Listing Subsystem Status: Example 4 
In this example, subsystem status report is being requested. 


//LISTDAT4 JOB 
//STEP1 ‘EXEC PGM=IDCAMS 
//LISTVOL2 DD — UNIT=3350,VOL=SER=VOL269,DISP=SHR 
//SYSPRINT 0D  SYSOUT=A 
//SYSIN OD * 
LISTDATA- 
STATUS- 
FILE(LISTVOL2) 
* 


/ 
Job control language statement: 
e LISTVOL2 DD, which specifies a 3350 unit for which subsystem status is being 
reported. . 
The LISTDATA command parameters are: 
e STATUS, which specifies that a Subsystem Status Report be printed. 


e FILE, which specifies LISTVOL2 as the DD statement that allocates a 3350 unit 
and volume VOL269. 
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Reports 


Use the LISTDATA command to list information about activity within the caching 
models of IBM storage controls. You can obtain two different types of reports: 
subsystem counters report and subsystem status report. Optionally, you can also 
obtain a legend for each report. This legend describes the headings used in the 
report. When you request a legend, it is printed at the end of the report. 


Subsystem Counters Reports 


The Subsystem Counters Report provides a record of the counters within the 
subsystem at the time the report is requested. The counters are not reset when the 
report is taken. 


Figure 14 is a sample Subsystem Counters Report for Model 11. 


IDCAMS SYSTEM SERVICES TIME: 12333337 


VOLUME PAGSAI] 


3350 SUBSYSTEM COUNTERS REPORT 


DEVICE T0cK"00" ~“SD< 1D. X' 00” 


DATA TRANSFERS ‘és READSs NO DASD ACCESS 

TOTAL PAGING 300300 N/A 300300 
NON-SEQUENT IAL 300300 300300 300300 
SEQUENTIAL 300300 300300 300300 
SWAP-INS 300300 300300 300300 
TOTAL/1000 900 900 900 

BLOCK WRITES 300300 

DASD UPDATES 300300 

BLOCK DISCARDS 300300 

BLOCK UPDATES 300300 


Figure 14. Sample Subsystem Counters Report for the IBM 3880 Storage Control Model 11 
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The report in Figure 15 is the corresponding legend of Figure 14 0n page 61. 


IDCAMS SYSTEM SERVICES TIME: 12:33:37 
LEGEND 


SUBSYSTEM COUNTERS LEGEND 
VOLUME VOLUME SERIAL NUMBER FOR WHICH THE DATA IS GATHERED 


DEVICE ID DEVICE IDENTIFICATION 
SD ID STORAGE DIRECTOR FOR WHICH THE DATA IS GATHERED 


DATA TRANSFERS NUMBER OF CCW CHAINS TO THIS DEVICE WITH A READ OR 
WRITE IN IT 


READS NUMBER OF READ CCWS 
NO DASD ACCESS - NUMBER OF CCW CHAINS FOR WHICH NO READS REQUIRED 
DASD ACCESS 


TOTAL PAGING 
NON-SEQUENTIAL - SET PAGING PARAMETER COMMANDS THAT WERE NOT SET 
SEQUENTIAL 
SEQUENTIAL SET PAGING PARAMETER COMMANDS THAT WERE SET 
SEQUENTIAL 
SWAP-INS SET PAGING PARAMETER COMMANDS SET FOR SWAP-IN 


TOTAL/1000 TOTAL DIVIDED BY 1000 FOR EACH VERTICAL LINE ITEM 


BLOCK WRITES 4K BLOCKS WRITTEN FROM THE HOST 

DASD UPDATES INTERNAL COMMAND CHAINS PERFORMING CACHE TO DASD 
TRANSFERS 

BLOCK DISCARDS BLOCKS AVAILABLE FOR REASSIGNMENT THROUGH DISCARD 

| BLOCK CCWS 

BLOCK UPDATES 4K BLOCKS WRITTEN FROM CACHE TO DASD 


Figure 15. Subsystem Counters Report Legend for the IBM 3880 Storage Control Model 11 


Subsystem Status Report 
The Subsystem Status Report provides a record of the status ein the subsystem 
at the time the report is requested. This report includes: 


e Address of the subsystem paging storage director. 
e Address of the device on which I/O was done. 


e Amount of subsystem storage that is CONFIGURED, AVAILABLE, OFFLINE, and 
PINNE D.1 


e 40 bytes of hexadecimal data representing subsystem status as it is returned 
from the subsystem before it is interpreted. 


1 The sum of AVAILABLE, PINNED, and OFFLINE is always less than CONFIGURED. The difference is the amount of 
storage occupied by control data and the space remaining after the storage director has allocated as many track 
slot segments as possible from the subsystem storage space which is not occupied by subsystem control data. 
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Figure 16 is a sample Subsystem Status Report for Model 11. 


( | IDCAMS SYSTEM SERVICES TIME: 10:17:25 
3350 SUBSYSTEM STATUS REPORT 
SD ID X'00' DEVICE ID X'00' 


SUBSYSTEM STORAGE IN BYTES 


CONFIGURED 6000000 
AVAILABLE 5000000 
OFFLINE 1000000 
PINNED 0 


RETURNED STATUS 0-19 Q0000000 DODDEAGD 00002710 D0000000 00000000 


20-39 F5000000 D0000000 H0D00000 O0D0D00D 00000000 


Figure 16. Sample Subsystem Status Report for the IBM 3880 Storage Control Model 11 


The report in Figure 17 is the corresponding legend of Figure 16. 


IDCAMS SYSTEM SERVICES TIMES TOs 17225 
LEGEND 


SUBSYSTEM STATUS LEGEND 


SD ID - ADDRESS OF THE SUBSYSTEM'S PAGING STORAGE 
DIRECTOR 

DEVICE ID - ADDRESS OF THE DEVICE ON WHICH THE I/0 
WAS DONE 


SUBSYSTEM STORAGE IN BYTES 


CONFIGURED STORAGE THAT EXISTS IN THE CACHE FOR THIS 
SUBSYSTEM 

AVAILABLE STORAGE THAT IS AVAILABLE FOR PAGING 

OFFLINE STORAGE THAT IS OFFLINE AND NOT AVAILABLE 
FOR PAGING 

PINNED STORAGE UNAVAILABLE BECAUSE OF CACHE TO DASD 
EXCEPTIONS 


RETURNED STATUS - INDICATES THE UNINTERPRETED DATA RETURNED 
FROM THE SUBSYSTEM FOR A STATUS REQUEST 


Figure 17. Subsystem Status Report Legend for the IBM 3880 Storage Control Model 11 
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Appendix A. Command Reference Summary 


This appendix shows the format of the access method services commands that you 
can use with each of the caching models of the IBM 3880 Storage Controls. See 
“DFP Support” on page 10 to determine the support for each cache controller. 


3880 Model 23 


LISTDATA LDATA 
{COUNTS|STATUS} CNT STAT 
| {FILE(ddname)|VOLUME(vo/lser)UNIT (unittype)} VOL 
[DEVICE|SUBSYSTEM|ALL] DEV SSYS SUBSYS 
| [LEGEND|NOLEGEND] LGND NOLGND 
[OUTFILE(ddname)|OUTDATASET(dsname)] OFILE ODS OUTDS 
[WTO] 

SETCACHE SETC 
{FILE(ddname)|VOLUME(vo/ser)UNIT (unittype)} VOL 
[DEVICE|SUBSYSTEM] DEV SSYS SUBSYS 
LON|OFF ] 


3880 Model 21 


Parameters Abbreviation 


LISTDATA LDATA 
{COUNTS|STATUS} CNT STAT 
{FILE(ddname)|VOLUME(vo/ser)UNIT (unittype)} ~ | VOL 
[DEVICE|SUBSYSTEM|ALL] DEV SSYS SUBSYS 


[LEGEND|NOLEGEND | LGND NOLGND 


| [OUTFILE(ddname)|OUTDATASE T(dsname) | | OFILE ODS OUTDS | 


SETCACHE SETC 
{FILE(ddname)|\VOLUME(vo/ser)UNIT (unittype)} VOL 
{SUBSYSTEM|DIRECTOR {1/2}} SSYS SUBSYS SD 
[ON|OFF] 


3880 Model 13 


BINDDATA BDATA 
{ESTABLISH|TERMINATE} ESTAB EST TERM 
{FILE(ddname)|VOLUME(vo/ser)UNIT (unittype)} | VOL 
[DEVICE|SUBSYSTEM] DEV SSYS SUBSYS 
[HIGHCCHH(cchh)] HCCHH 
[LOWCCHH(cchh) ] LOCHH 
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Parameters Abbreviation 


LISTDATA LDATA 
{COUNTS|STATUS} CNT STAT 
{FILE(ddname)|VOLUME(vo/ser)UNIT (unittype)} VOL 
[DEVICE |SUBSYSTE M/ALL ] DEV SSYS SUBSYS 
[LEGEND|NOLEGEND ] LGND NOLGND 
[OUTFILE(ddname)|OUTDATASE T(dsname) ] OFILE ODS OUTDS 
[WTO] 


Parameters Abbreviation 


SETCACHE SETC 
{FILE(ddname)|VOLUME(vo/ser)UNIT (unittype)} VOL 


[DEVICE |SUBSYSTEM] DEV SSYS SUBSYS 
LON|OFF] 


3880 Model 11 


LISTDATA LDATA 
{COUNTS|STATUS} CNT STAT 
{FILE(ddname)|VOLUME(vo/ser) UNIT (unittype)} VOL 


[DEVICE |SUBSYSTEM|ALL ] 
[LEGEND|NOLEGEND] 
[OUTFILE(ddname)|OUTDATASE T(dsname) ] 


DEV SSYS SUBSYS 
LGND NOLGND 
OFILE ODS OUTDS 
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Appendix B. User Access to Subsystem Status and Counts 


Information 


This appendix documents product-sensitive programming interfaces and 
associated guidance information provided by IDCAMS. 


A user access is provided specifically for non-access method services callers (for 
example, the Cache RMF Reporter). Its purpose is to invoke the access method 
services LISTDATA routine (IDCSS01) to obtain subsystem status or count 
information. To obtain this information, the caller must be in an authorized library 
before linking to |IDCSS01, which is contained in SYS1.LINKLIB. The caller passes 
to IDCSS0O1 a 3-word parameter list pointed to by register 1. If the caller is not 
authorized and attempts to link to |DCSS01, the system abends with error code 047. 


The Cache RMF Reporter (5798-DQD), an IBM Program Offering, implements the 
user access to subsystem status and counts through LISTDATA. It consists of RMF 
user exits and a batch post processor report program. The RMF exit obtains all 
subsystem counts and status, calculates the difference in the device counts (from 
the previous read), and writes these values and the subsystem status to the system 
management facilities (SMF) data set as user records. Statistics such as hit ratios 
and read-to-write ratios are calculated by the post processor report program. A 
detailed explanation of this program offering can be found in the Cache RMF 
Reporter Description/Operation Manual. 


Register 1 Parameter List 


Word 1 
must be zero. 


Word 2 
contains an address of a pointer to the argument list SSGARGL (detailed 
below), which IDCSS01 requires. Within this argument list is a field named 
SSGOADR, which points to the buffer area in which IDCSS01 returns 
subsystem status or counts information. The buffer area may be obtained by 
the caller or may be left for |DCSS01 to obtain. 


Word 3 
points to a 2-byte binary return code. 


Possible return codes are: 


O — Successful completion 

4 — GETMAIN failure 

8 — |/O error 

12 — Requested volume not found 

16 — ESTAE not established 

20 — Real address in SSGOADR not valid 

24 — Passed buffer not large enough 

28 — ddname not found in TIOT 

32 — Requested volume not found on ALL request 
36 — Path to storage director(s) not available 

40 — No paths available 

44 — Subsystem/device does not support request 
56 — AOMSERV macro error occurred. 
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Note: If you pass the buffer, or if the return code is not 4, 12, or 28, the calling 
routine is responsible for freeing the buffer. 


Passed Argument List — SSGARGL 


The following describes SSGARGL. SSGARGL is the area pointed to by the word 
that Word 2 points to. Word 2 is part of the parameter list passed to |IDCSSO1. The 
caller must establish some fields; IDCSS01 establishes other fields. 


The caller must set an option flag to indicate whether information requested is 
status (SSGRSS) or counts (SSGRPD) information. If counts information is 
requested, the caller must indicate whether it applies to all subsystems (SSGALL), 
a specific subsystem (SSG1SS), or a specific device (SSGDEV). 


In addition, the caller must either pass the ddname (through SSGADDN) of a DD 
statement that allocates a caching subsystem volume, or the caller must identify 
the volume and unit (through SSGAVOL and SSGUNIT) of a caching subsystem 
volume for which information is being requested. If the caller passes SSGADDN, 
IDCSS01 establishes SSGAVOL and SSGUNIT. The following list contains other 
fields that IDCSS01 establishes. 


Offset 
0(0) 
8(8) 


12(C) 


Bytes 


8 
4 


4 


Field Name 
SSGHEAD 
SSGADDN 


SSGAVOL 


Description: Contents 
Will be set to SSGARGL by IDCSS01. 


Address of ddname; zero if none. Volume 
serial number and device type are 
retrieved from UCB if nonzero. Return 
code 28 if the ddname pointed to by 
SSGADDN is not found in the task 
input/output table. 


Address of volume serial; zero if none. 
Return code 12, if the volume serial 
number pointed to by SSGAVOL is not 
found in the UCBs. Counts information is 
obtained for all like subsystems when the 
volume serial number is unknown, by 
pointing to the model number in the form 
‘FFFFFFFFFFxx’, where ‘xx’ is: 


X'08' for an 1BM 3880 Model 11 
X'09' for an IBM 3880 Model 13 
X'0A' for an IBM 3880 Model 21 
X'0B' for an IBM 3880 Model 23 
X'0C' for an IBM 3990 Model 3 
X'0D' for an IBM 3880 Model 23 with 
3380 AJ4/AK4 Attachment Feature. 


Note: X'0B' and X'0D' produce the same results. If either X'0B' or X'0D' is specified, 
information is returned for all Model 23s whether or not 3380 AJ4/AK4 Attachment 
(Feature 3010) is installed. 


16(10) 


20(14) 
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4 


4 


SSGUNIT 


SSGOLN 


Four-byte unit type (required when the 
address of the volume serial number is 
used). The format is that of UCBTYP (for 
example, X'3010200E '). 


Length of buffer storage area. 


Offset 
24(18) 


28(1C) 


29(1D) 


30(1E) 
31(1F) 


Bytes 


111 1111 
1 
1 


Field Name 


SSGOADR 


SSGOPT 
SSGRPD 
SSGRSS 
SSGCACHE 


SSGSDS 


SSGALL 
SSG1SS 
SSGDEV 
SSGAMD 


SSGOPT 
SSG2SD 
SSGMDLID 
SSGRCIOS 


Description: Contents 


Address of buffer area. The calling 
routine is responsible for freeing the 
buffer area. A return code of 20 indicates 
that the Load Real Address (LRA) 
instruction failed. 


Reserved. 
Request to sense subsystem counts. 
Request to sense subsystem status. 


Set off for 3880 Models 11 and 21; on for 
3880 Models 13, 23, 3880 Model 23 with 
3380 AJ4/AK4 Attachment (Feature 3010) 
and 3990 Model 3. 


Set on for 3880 Model 11, and 3990 Model 
3; off for 3880 Models 13, 21, 23, and 3880 
Model 23 with 3380 AJ4/AK4 Attachment 
(Feature 3010). 


Request counts for all like subsystems. 
Request counts for a specified subsystem. 
Request counts for a specified device. 


Pointer to 3880 model passed instead of a 
pointer to the volume. 


Reserved. 
Reserved. 
Reserved. 
Subsystem identifiers. 


IOS return code. 


Note: SSGAMD must be set on to indicate that the model was passed instead of 
the volume pointer. SSGALL must be set on to indicate that the request is 
for all subsystem counts. A return code of 12 indicates an invalid model. 


Buffer Area Returned from IDCSS01 


For each volume in the subsystem, the request for counts returns the following 
information for each volume. If subsystem status was requested, only one entry 
per subsystem is returned with the volume and unit address specifying the unit 
used for the I/O operation. 


Offset 
0(0) 


6(6) 
8(8) 


Bytes Field Name 
6 SSGDAVOL 
2 — 

3 SSGDAUAT 


Description: Contents 


SSGDAVOL contains the volume serial 
number. For multiple entries in the 
buffer (other than subsystem status) 
the last entry is followed by 6 bytes of 
binary zeros. 


Reserved. 


Three-character unit address. 
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Offset Bytes Field Name Description: Contents 


11(B) 3 SSGDAUVUA2 Three-character unit address second | 
read; valid for all models except 3880 
Model 11 and 3990 Model 3. 


14(E) 2 SSGDALN Data length. 


16(10) var SSGDADA Data returned from the subsystem 
through status and counts request(s). 


The following fields constitute SSGDADA: 


40 SSGDASS Subsystem status entry length for 3880 
Models 11, and 13 and 3990 Model 3. 
80 SSGDA2SD Subsystem status entry length for 3880 


Models 21, 23, and Model 23 with 3380 
AJ4/AK4 Attachment (Feature 3010). 


80 SSGDAIPF Subsystem counts entry length for 
3880 Model 11. 

96 SSGDAXPF Subsystem counts entry length for 
3990 Model 3. 

160 SSGDASPF Subsystem counts entry length for 


3880 Models 13, 21, or 23. 


The format of the data provided is returned from the subsystem in response to 
SENSE SUBSYSTEM STATUS, SENSE SUBSYSTEM COUNTS, and READ 
SUBSYSTEM DATA commands. For further information, see IBM 3880 Storage 
Control Description manuals for all caching models or /BM 3990 Storage Control 
Reference. 
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Acronyms and Abbreviations 


This list contains definitions for acronyms and 
abbreviations used in the various books in the Storage 
Subsystem Library. The terms in this list are not 
necessarily used in this specific book. Some terms are 
more specifically defined in the glossary. 


ACB 
ACS 
ACDS 
AIX 
ASCII 


BCS 
BDAM 
BPAM 
BSAM 
BSDS 
CCHH 


CCHHR 


CCW 
CHL-I 
CHPID 
Cl 
CKD 
CMS 
CP 
CTC 
CTL-I 
CVOL 
DASD 
DCB 
DD 
DFDSS 


DFHSM 


DFP 


DFSORT 


DL 
DLS 
DLSE 
DPS 


Access method control block 
Automatic class selection 
Active control data set 
Alternate index 


American National Standard Code for 
Information Interchange 


Basic catalog structure 

Basic direct access method 
Basic partitioned access method 
Basic sequential access method 
Bootstrap data set 

Cylinder, cylinder, head, head 
Cylinder, cylinder, head, head, record 
Channel command word 
Channel interface 

Channel path identifier 

Control interval 

Count-key-data 

Conversational Monitor System 
Control program 
channel-to-channel 

Control interface 

Control volume 

Direct access storage device 
Data control block 

Data definition 

Data Facility Data Set Services. 
Data Facility Hierarchical Storage Manager 
Data Facility Product 

Data Facility Sort 

Data length 

Device level selection 

Device level selection enhanced 


Dynamic path selection 
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EBCDIC Extended binary coded decimal interchange 


ECKD 
EOF 

ERDS 
EREP 


ESDS 
EXCP 
ESQA 
FBA 
FCCHH 
FRU 
GB 
GDG 
GRS 
GTF 
HA 


ISMF 


code 

Extended count-key data 
End-of-file 

Error recording data set 


Environmental Record Editing and Printing 
program 


Entry-sequenced data set 

Execute channel program 
Extended system queue area 
Fixed-block architecture 

Flag, cylinder, cylinder, head, head 
Field replaceable unit 

Gigabyte 

Generation data group 

global resource serialization 
Generalized trace facility 

Home address 

Head-disk assembly 

Identifier 

Initial microcode load 

1/O configuration program 
Input/output device generation 
Information Management System 
Input/output 

Initial program load 

Indexed sequential access method 


International Reference Version of the 
International Standard for Information 
Interchange 


Interactive Storage Management Facility 


ISPF/PDF Interactive System Productivity Facility / 


JCL 
JCT 
JES 
KL 
KSDS 
KVA 
LDS 


Program Development Facility 
job control language 

JES control table 

Job entry subsystem 

key length 

Key-sequenced data set 
kilovolt ampere 


Linear data set 
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LRU Least recently used algorithm 
MAP Maintenance analysis procedure 
MB megabyte 


MPSD Mulitpath storage director 
MVSCP MVS configuration program 
NVS Nonvolatile storage 


OLTEP Online Test Executive Program 


OS Operating system 
PAM Partitioned access method 
PFK Program function keyboard 


PLPA Pageable link pack area 

PTF Program temporary fix 

RO Record zero 

RACF Resource Access Control Facility 
RMF Resource Measurement Facility 
RPS Rotational position sensing 


RRDS Relative record data set 


RTM/SF Realtime Monitor / Systems Facility 


SAM Sequential access method 
SCA Shared control array 
SCDS Source control data set 
SF Support facility 


SIM Service information message 
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SLR 
SMF 
SML 
SMS 
SQL/DS 
SSID 
TCO 
TPF 
TsO 
TTR 
UCB 
UuCW 
vio 
VMMAP 
VMPPF 
VMPRF 
VSAM 
VTAM 


Service Level Reporter 

System Management Facilities 
MVS Storage Management Library 
Storage Management Subsystem 
Structured Query Language / Data System 
Subsystem identifier 

Triple Capacity Option 

Transaction Processing Facility 
Time sharing option 

Track record 

Unit control block 

unit control word 

Virtual input/output 

VM Monitor Analysis Program 

VM Performance Planning Facility 
VM Performance Reporting Facility 
Virtual storage access method 
Virtual telecommunications access method 
Volume table of contents 

VSAM volume data set 

Write to operator 


Extended architecture 


1 


Glossary 


This glossary contains disk storage subsystem terms 
used in the various books of the Storage Subsystem 
Library (SSL). 


Each of the terms included here is not necessarily used 
in this specific book. If you do not find the term you are 
looking for, refer to the index or to Dictionary of 
Computing, SC20-1699. 


A 


A-unit. The direct access storage unit that contains the 
controller functions to attach to the storage control. An 
A-unit controls the B-units that are attached to it and is 

often referred to as a head of string. 


access authorization. Bits in the Define Extent file 
mask that define one of the three authorization groups 
for a channel program (normal authorization, device 
support authorization, or diagnostic authorization). 


access mechanism. See actuator. 


active duplex state. A state of operation that occurs 
when both devices in a dual copy logical volume are 
automatically updated. See also duplex state and 
suspended duplex state. 


actuator. A set of access arms and their attached 
read/write heads, which move as an independent 
component within a head and disk assembly (HDA). 
See also device and volume. 


alternate track. On a direct access storage device, a 
track designated to contain data in place of a defective 
primary track. 


B-unit. A direct access storage unit that attaches to 
the subsystem through an A-unit. 


Cc 


C-unit. A direct channel attach 3380 direct access 
storage unit that contains both the storage control 
functions and the DASD controller functions. A 3380 
C-unit (3380 Model CJ2) functions as a head of string 
and controls the B-units that are attached to it. 


cache. Arandom access electronic storage in 
selected storage controls used to retain frequently 
used data for faster access by the channel. For 
example, 3990 Model 3 contains cache. 
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cache fast write. A form of fast write where the data is 
written directly to cache without using nonvolatile 
storage and is available for later destaging. This 3990 
Model 3 Storage Control function should be used for 
data of a temporary nature, or data which is readily 
recreated, such as the sort work files created by the 
appropriate release of DFSORT. 


cache fast write data. Data that the channel command 
modifies in cache and not on DASD. It has read-hit 
performance benefits for write hits. See cache fast 
write and cache fast write identifier. 


cache fast write identifier. An identification to ensure 
that a program does not access data in cache that is 
down-level data. 


channel connection address. The I/O address that 
uniquely identifies an I/O device to the channel durin 
an I/O operation. : 


channel interface (CHL-I). The circuitry of a storage 
control that attaches storage paths to a host channel. 


check-1 error. In the storage control and DASD, an 
error that does not allow the use of normal machine 
functions to report details of the error condition. 


check-2 error. In the storage control and DASD, an 
error that can be reported using the normal machine 
functions. 


cluster. See storage cluster. 


concurrent maintenance. The capability that permits a 
service representative to perform a service action ona 
storage control or DASD while normal operations 
continue on hardware not affected by the service 
action. 


concurrent media maintenance. The capability that 
enables a customer to perform maintenance on a track 
while allowing user access to that data. 


connection check alert. The electronic signal used by 
the DASD to indicate a check-1 error condition to the 
storage control. See check-1 error. 


contingent allegiance. A state the storage path 
establishes for an I/O device that allows only the 
channel path that is communicating with the I/O device 
to continue to do so. This state occurs when the 
channel accepts a status byte that contains unit check. 


control interface (CTL-I). The hardware connection 


between the storage control function and the DASD 
controller function. 
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control unit. A hardware unit that controls the reading, 
writing, or displaying of data at one or more 
input/output devices. See also storage control. 


controller. The hardware component of a DASD head 
of string unit that provides the path control and data 
transfer functions. For example, 3390 A-units have four 
controllers, and there are two controllers in a 3380 
Model AE4, AK4, or CJ2. See also device adapter. 


controller address. The 1-bit address used by the 
storage control to direct commands to the correct 
DASD string on the CTL-I. Controller address applies 
to the 3380 Models AA4, AD4, and AE4. See also string 
address. 


controller !D. An 8-bit identifier that uniquely identifies 
the physical string regardless of the selection address. 
It identifies to the service representative, by means of 
EREP, a failing subsystem component (controller or 
device) without having to translate a selection address 
(which may have little relation to a physical address) to 
a physical component. The controller ID is the number 
shown on the operator panel. Controller ID applies to 
the 3380 Models AA4, AD4, and AE4. See also string 
ID. 


count-key-data (CKD). A DASD data recording format 
employing self-defining record formats in which each 
record is represented by a count area that identifies the 
record and specifies its format, an optional key area 
that may be used to identify the data area contents, and 
a data area that contains the user data for the record. 
CKD is also used to refer to a set of channel commands 
that are accepted by a device that employs the CKD 
recording format. See extended count-key-data 
architecture. 


D 


DASD. Direct access storage device. 


DASD fast write. A form of fast write to cache where 
the data is written concurrently to cache and 
nonvolatile storage and automatically scheduled for 
destaging to the DASD. Both copies are retained in the 
storage control until the data is completely written to 
the DASD, providing data integrity equivalent to writing 
directly to the DASD. DASD fast write is available with 
a 3990 Model 3 Storage Control. 


DASD subsystem. One or more DASD strings and the 
storage control(s) to which the DASD are attached. 


demotion. The process of removing the image of one 
or more records from cache. A set of one or more 
DASD records is demoted either by being selected for 
replacement (overlay) by another set of DASD records 
or by being marked invalid. Compare to promotion. 
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destage. The asynchronous write of new or updated | 
data from cache or nonvolatile storage to DASD. This 
is used only for the fast write and dual copy functions of 
3990 Model 3. See also fast write and write hit. 


device. A uniquely addressable part of a DASD unit 
that consists of a set of access arms, the associated 

disk surfaces, and the electronic circuitry required to 
locate, read, and write data. See also volume. 


device adapter (DA). The hardware component of a 
3390 head of string unit that provides the path control | 
and data transfer functions. See also controller. 


device address. Three or four hexadecimal digits that 
uniquely define a physical !/O device on a channel path 
in System/370 mode. The one or two leftmost digits are 
the address of the channel to which the device is" 
attached. The two rightmost digits represent the unit 
address. 


device ID. An 8-bit identifier that uniquely identifies a 
physical I/O device. 


device level selection (DLS). A DASD function 
available with 3380 Models AD4, BD4, AE4, BE4, AJ4, 
BJ4, AK4, BK4, and CJ2. With DLS, each of the two 
controllers in the DASD string has a path to all devices 
in the string, and any two devices in the 2-path DASD 
string can read or write data simultaneously. See DLS 
mode. 


device level selection enhanced (DLSE). A DASD 
function providing four data transfer paths to each 
device in a 4-path DASD string. With DLSE, any four 
devices in a 4-path DASD string can read or write data 
simultaneously. See DLSE mode. 


device number. Four hexadecimal digits that logically 
identify an I/O device in a System/370 Extended 
Architecture or Enterprise Systems Architecture/370 
Systems. 


device release. A command that terminates the 
reservation of the device from the channel issuing the 
command or from all channels on the interface path 
group. 


device reserve. A command that reserves the device 
for the channel issuing the command, or for all 
channels in the same interface path group. 


device support authorization. Channel programs 
executing with this authorization can access all tracks 
in all track groups, and can execute all Locate Record 
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operations. 7 


Device Support Facilities program (ICKDSF). A | 
program used to initialize DASD at installation and 
provide media maintenance. | 


device support tracks. Reserved tracks of a DASD 
volume that may be used to store the subsystem status 
information used by cached subsystems (for example 
at IML time), and defect skipping information on some 
device types. 


diagnostic authorization. Channel programs using 
diagnostic authorization can access only the diagnostic 
and device support tracks. 


diagnostic tracks. Tracks used by the diagnostic 
programs for testing the read/write function. 


director. See storage director. 


director-to-device connection (DDC). The control 
interface that connects a storage path in the storage 
control to a controller in the DASD A-unit. 


diskette drive. A direct access storage device that 
uses diskettes as the storage medium. A 3880 uses a 
read-only diskette drive for microcode storage; 3990s 
and 3380 Model CJ2s use read/write diskette drives for 
microcode storage and error logs. 


DLS mode. A mode of operation in a 3990 Storage 
Control that supports 3380 2-path strings. DLS mode 
must be specified by the IBM service representative at 
installation for the 3990. See single-path storage 
director. 


DLSE mode. A mode of operation in a 3990 Model 2 or 
3 Storage Control that supports 3380 AJ4 and AK4 
4-path strings and 3390 strings. DLSE mode must be 
specified by the IBM service representative at 
installation time for the 3990. See multipath storage 
director. 


domain. A scope of operations control that spans all 
the parameters specified by the Locate Record 
command. For example, the Locate Record command 
allows only certain commands, and the commands 
must be in a correct sequence. 


See also locate record domain. 


DPS array. An electronic storage area that contains 
device status information. When any 3380 A-unit, 
except Model A04, is attached to a 3880 Storage 
Control, the DPS array resides in the A-units. When the 
same models are attached to a 3990, the DPS array 
function is part of the 3990 shared control array. The 
3380 Model CJ2 contains DPS array in the storage 
control function. 


dual copy. A high availability function made possible 
by nonvolatile storage in a 3990 Model 3. Dual copy 
maintains two functionally identical copies of 
designated DASD volumes in the logical 3990 Model 3 
subsystem, and automatically updates both copies 


every time a write operation is issued to the dual copy | 


logical volume. 


dual copy logical volume. A logical volume comprised 
of two physical devices with all data recorded twice, 
once on each device. A 3990 Model 3 Storage Control 
automatically ensures that both devices are updated 
with each write operation to the dual copy volume. 
Also called a duplex pair. 


dual-frame configuration. Consists of two like storage 
controls physically interconnected. Pairs of 3880 Model 
13 or Model 23 and 3990 Model 2 or Model 3 Storage 
Controls can be dual-framed. In a dual-frame 
configuration, each storage director in a logical DASD 
subsystem is in a different storage control. When a 
3990 Storage Control is in DLS mode, each DASD string 
has one path to a single-path storage director in each 
of the 3990 Storage Controls. When a 3990 Storage 
Control is in DLSE mode, each DASD string has two 
paths to a multipath storage director in each of the 3990 
Storage Controls. 


duplex pair. See dual copy logical volume. 


duplex state. Two devices in a 3990 Model 3 
subsystem are in duplex state when they have been 
made into a dual copy logical volume. 


dynamic path reconnect. A function that allows 
disconnected DASD operations to reconnect over any 
available channel path rather than being limited to the 
one on which the I/O operation was started. Itis 
available only on System/370 Extended Architecture 
and Enterprise Systems Architecture/370 Systems. For 
example, when a host has four channels connected to 
3990 Storage Control (in DLSE mode) with a 4-path 
DASD string, any device can reconnect on any one of 
four channel paths, providing improved performance 
and availability. 


dynamic path selection (DPS). DASD subsystem 
functions available with all 3380 heads of string except 
Model A04. These functions include: 


* Two controllers providing data paths from the 3380 
strings to the storage directors 

¢ Simultaneous transfer of data over two paths to two 
devices, providing the two devices are on separate 
internal paths within the string 

¢ Sharing DASD volumes by using System-Related 
Reserve and Release 

¢ Providing dynamic path reconnect to the first 
available path. 


environmental data. Data the 3990 must report to the 
host; the data can be service information message 
(SIM) sense data, logging mode sense data, an error 
condition that prevents completion of an asynchronous 
operation, or a statistical counter overflow. The 3990 
reports the appropriate condition as unit check status 
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to the host during a channel initiated selection. Sense 
byte 2, bit 3 (environmental data present) is set to 1. 


Environmental Record Editing and Printing (EREP) | 
program. The program that formats and prepares 
reports from the data contained in the Error Recording 
Data Set (ERDS). 


erase. To remove data from a data medium, leaving 
the medium available for recording new data. 


error burst. A sequence of bit errors counted as one 
unit, or burst. 


error correcting code (ECC). A code designed to 
detect and correct error bursts by the use of check 
bytes. 


extended count-key-data. A set of channel commands 
that use the CKD track format. Extended 
count-key-data uses the Define Extent and Locate 
Record commands to describe the nature and scope of 
a data transfer operation to the storage control to 
optimize the data transfer operation. The 3990 Storage 
Control supports the extended count-key-data 
commands. 


extent. A set of consecutively addressed tracks that a 
channel program can access. The limits of an extent 
are defined by specifying the addresses of the first and 
last tracks in the extent. 


fast dual copy. A dual copy capability where DASD 
fast write and dual copy are active concurrently to 


provide a significant dual copy performance 
enhancement. | 


fast write. In a3990 Model 3 Storage Control, a write 
operation at cache speed that does not require 
immediate transfer of data to a DASD. The data is 
written directly to cache and/or nonvolatile storage and 
is available for later destaging. Fast write reduces the 
time an application must wait for the I/O operation to 
complete. See also DASD fast write, cache fast write, 
and destage. 


fence. To separate one or more paths or elements 
from the remainder of the logical DASD subsystem. 
The separation is by logical boundaries rather than 
power boundaries. This separation allows isolation of 
failing components so that they do not affect normal 
operations. 


G 


gigabyte (GB). 109 bytes. 
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H 


head and disk assembly (HDA). A field replaceable 
unit in a direct access storage device containi ing the 
disks and actuators. 


head of string. The unit in a DASD string that contains 
controller functions. Also called the A-unit. See also 
device adapter. 


home address (HA). The first field on a CKD track that 
identifies the track and defines its operational status. 
The home address is written after the index pan on 
each track. 


ICKDSF. See Device Support Facilities program. 


IDCAMS. Acomponent of Data Facility Product that is 
also referred to as access method services. 


identifier (ID). A sequence of bits or characters that 
identifies a program, device, controller or system. 


IML device. The diskette drive that reads the 
microcode for the storage control. See diskette drive. 


index point. The reference point on a disk surface that 
determines the start of a track. 


initial microcode load (IML). The act of loading 
microcode. 


invalidation. The process of removing records from 
cache because of a change in status of a subsystem 
facility or function, or because of an error while 
processing the cache image of the set of records. 
When such a cache image is invalidated, the 
corresponding records cannot be accessed in cache 
and the assigned cache space is available for 
allocation. 


— (/0 device. An addressable input/output unit, such as 


a direct access storage device, magnetic tape device, 
or printer. 


K 


kilobyte (KB). 1024 bytes. 


L 


least recently used algorithm (LRU). The algorithm _ 
used to identify and make available the cache space 
that contains the least recently used data. 


locate record domain. The part of a channel command 
chain immediately following a Locate Record command 


that must follow the restrictions imposed by operations 
the Locate Record parameters specify. The domain is 
in effect for the number of records or tracks that the 
count parameter specifies. 


See also domain. 


logical DASD subsystem. Two storage directors 
attached to the same DASD strings together with those 
DASD strings. 


maintenance analysis procedure (MAP). A 
step-by-step procedure for tracing a symptom to the 
cause of a failure. 


media. The disk surface on which data is stored. 


media SIM. A message generated when 3390 detects 
a device media fault that requires media maintenance. 
See also service information message (SIM). 


megabyte (MB). 106 bytes. 


multipath storage director. A storage director ina 
3990 Storage Control operating in DLSE mode. Each 
multipath storage director in a storage control is 
associated with two storage paths. All storage paths in 
a multipath storage director respond to the same range 
of controi unit addresses on a channel. 


multitrack operations. A mode of operation in which 
the storage director advances to the next track when 
the operation continues past the end of a track. 


nondisruptive installation. Allows customer operations 
to continue concurrently with the physical installation of 
an additional 4-path DASD string (or 4-path DASD 
B-units), to an existing 4-path DASD subsystem. This 
provides access to data on the existing units while 
installation activity is in progress. Nondisruptive 
installation is available when only 4-path DASD are 
attached to a properly configured 3990 Model 2 or 
Model 3 Storage Control. 


nondisruptive removal. Allows customer operations to 
continue concurrently with the physical removal of a 
4-path DASD string (or 4-path DASD B-units), from an 
existing 4-path DASD subsystem. This provides access 
to data on the unaffected units while removal activity is 
in progress. Nondisruptive removal is available when 
only 4-path DASD are attached to a properly configured 
3990 Model 2 or Model 3 Storage Control. 


nonvolatile storage (NVS). Additional random access 
electronic storage with a backup battery power source, 
available with a 3990 Model 3 Storage Control, used to 
retain data during a power failure. Nonvolatile storage, 


accessible from all storage directors, stores data 
during DASD fast write and dual copy operations. 


normal authorization. A channel program executing 
with normal authorization cannot access the diagnostic 
or device support tracks. 


O 


orient. An operational code of the Locate Record 
command that prepares the storage director to position 
the DASD to the seek address and sector number 
parameters. 


orientation. A control state within a storage path that 
indicates the type of area (home address, count, key, or 
data field) that has just passed under the read/write 
head of the device. 


p 


physical ID. A unique designation to identify specific 
components in a data processing complex. 


pinned data. Data that is held in a 3990 Model 3 
Storage Control, because of a permanent error 
condition, until it can be destaged to DASD or until it is 
explicitly discarded by a host command. Pinned data 
exists only when using fast write or dual copy 
functions. 


predictable write. A fast write operation that formats, 
in cache only, the entire user area of the track and 
creates a track image. This full-track image is 
available for later destaging to a DASD. 


primary device. One device of a dual copy volume. 
All channel commands to the dual copy logical volume 
are directed to the primary device. The data on the 
primary device is duplicated on the secondary device. 
See also secondary device. 


primary track. On a direct access storage device, the 
original track on which data is stored. See also 
alternate track. 


promotion. The process of moving a track image from 
a DASD to cache. 


Q 


quiesce. A function on a 3990 Model 2 or 3 Storage 
Control in DLSE mode, configured with only 4-path 
strings. This function makes one component of a 
storage subsystem temporarily unavailable to the 
processor while assuring that the remaining 
components are available for data transfer. For 
example, components of a storage subsystem are 
storage path, controller, and DASD string. This 
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function is initiated by a service representative. 
Contrast with resume. 


R 


read hit. When data requested by the read operation 
are in the cache. 


read miss. When data requested by the read operation 
~ are not in the cache. 


release. A facility that allows other host systems to 
communicate with the reserved device. Contrast with 
reserve. 


reserve. A facility for devices attached to multiple 
channel paths. It allows only one host system to 
communicate with the specified device. Contrast with 
release. 


resume. A function on a 3990 Model 2 or 3 Storage 
Control in DLSE mode, configured with only 4-path 
strings. This function enables a component that has 
been quiesced. This function is initiated by a service 
representative. Contrast with quiesce. 


rotational position sensing (RPS). A function that 
permits a DASD to reconnect to a block multiplexer 
channel when a specified sector has been reached. 
This allows the channel to service other devices on the 
channel during positional delay. 


secondary device. One of the devices in a dual copy 
logical volume that contains a duplicate of the data on 
the primary device. Unlike the primary device, a 


limited subset of channel commands may be directed 
to the secondary device. See also primary device. 


service information message (SIM). A message that 
appears on the operator console and in EREP reports, 
generated by a 3990, a 3380 Model CJ2, or a 3390, that 
contains notification of a need for repair or customer 
action. The SIM identifies the affected area of the 
storage control or device and the effect of the service 
action. See also media SIM. 


shared control array (SCA). An electronic storage 
area in a 3990 Storage Control containing status 
information about its own cluster and the other storage 
cluster in the logical DASD subsystem. The information 
contained in the shared control array is replicated in 
each storage cluster in that subsystem. 


SIM Alert. An operator console message that alerts 
the operator that an action requiring attention has 
occurred. The service information message (SIM) can 
be obtained from the EREP exception report. 
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simplex state. A volume is in the simplex state if itis 
not part of a dual copy logical volume. Terminating a 
dual copy logical volume returns the two devices to the 
simplex state. In this case, there is no longer any 
capability for either automatic updates of the secondary 
device or for logging changes, as would be the case in 
suspended duplex state. 


single-frame configuration. In a single-frame 
configuration, the storage directors of a logical DASD 
subsystem are located inside one storage control. 
Contrast with dual-frame configuration. 


single-path storage director. A storage director ina 
3990 or 3380 Mode! CJ2 operating in DLS mode. Each 
single-path storage director in the storage cluster is 
associated with one storage path. A storage path ona 
single-path storage director responds to a unique 
control unit address on the channel. A single-path 
storage director in a 3990 is like a storage director ina 
3880. 


stage. The process of writing data from a DASD to the 
cache. 


state-change interruption. A combination of bits in the 
status byte that occurs for a change in the subsystem 
or the device. For example, a state-change interruption 
can occur when a volume changes from simplex to 
duplex. The bit combination is attention, device end, 
and unit exception. This interruption is sent to all hosts 
to inform them of the state change. 


This was formerly called pack-change interruption. 


storage cluster. In the 3990 Storage Control and 3380 
Model CJ2, a power and service region containing two 
independent transfer paths. See also storage director, 
single-path storage director, and multipath storage 
director. 


storage control. The component in a DASD subsystem 
that connects the DASD to the host channels. It 
performs channel commands and controls the DASD 
devices. For example, the 3990 Model 2 and Model 3 
are storage controls. 


storage director. In a 3990 storage control, a logical 
entity consisting of one or more physical storage paths 
in the same storage cluster. In a 3880, a storage 
director is equivalent to a storage path. See also 
storage path, single-path storage director, and 
multipath storage director. 


storage director ID. For 3880 Storage Control 
configurations, an 8-bit designation that uniquely 
identifies the storage director regardless of its 
selection address. It identifies to the service 
representative, by means of EREP, a failing subsystem 
component (storage director) without having to 
translate a selection address (which may have little 
relation to a physical address) to a physical 


component. The storage director ID is the number 
shown on the operator panels of 3880s and the attached 
DASD units. For 3990’s, see subsystem identifier 
(SSID). 


storage management subsystem (SMS). An operating 
environment that helps automate and centralize the 
management of storage. To manage storage, SMS 
provides the storage administrator with control over 
data class, storage class, management class, storage 
group and automatic class selection routine definitions. 


storage path. The hardware within the 3990 Storage 
Control that transfers data between the DASD and a 
channel. See also storage director. 


storage subsystem. One or more storage controls and 
their attached storage devices. 


string. A series of connected DASD units sharing the 
same A-unit (or head of string). 


string address. The 1-bit address used by the storage 
control to direct commands to the correct 3380 AJ4/AK4 
or 3390 DASD string on the CTL-I. See also controller 
address. 


string ID. An 8-bit identifier that uniquely identifies the 
physical string regardless of the selection address. It 
identifies to the service representative, by means of 
EREP, a failing subsystem component (controller or 
device) without having to translate a selection address 
(which may have little relation to a physical address) to 
a physical component. The string ID is the number 
shown on the operator panel of the DASD A-unit. See 
also controller ID. 


substring. !n a4-path AJ4/AK4 DASD configuration, 
one of the two A-units and the physically adjacent 
B-units (as many as three B-units). 


subsystem identifier (SSID). In a 3990 Storage Control 
configuration, a number that identifies the physical 
components of a logical DASD subsystem. This 
number is set by the service representative at time of 
installation, and is included in the vital product data in 
the support facility. This number is identified on the 
DASD A-units and 3990 operator panels. 


subsystem storage. A term used for cache in a 3880 
Model 13 or 23. See cache. 


support facility (SF). A component of each 3990 and 
3380 Model CJ2 storage cluster that provides initial 
microcode load, error logging, maintenance panel, 
MAPs, and microdiagnostic functions for that cluster. 


suspended duplex state. When only one of the devices 
in a dual copy logical volume is being updated because 
of either a permanent error condition or an authorized 
user command. All writes to the remaining functional 


ee se 


device are logged. This allows for automatic 
resynchronization of both volumes when the dual copy 
logical volume is reset to the active duplex state. 


system-managed storage. An approach to storage 
management in which the system determines data 
placement and an automatic data manager handles 
data backup, movement, space and security. 


T 


track compatibility mode. See 3380 track compatibility 
mode 


U 


unit address. The last two hexadecimal digits of a DAS 
device address. This identifies the storage control and 
DAS string, controller, and device to the channel 
subsystem. Often used interchangeably with control 
unit address and device address in System/370 mode. 


V 


vital product data (VPD). Nonvolatile data that includes 
configuration data, machine serial number, EC level, 
and machine features. It is maintained by the 3990 
support facility. It is stored in the 3990 support facility 
and 3390. 


volume. The DASD space accessible by a single 
actuator. 


W 


write hit. When data requested by the write operation 
are in the cache. 


write miss. When data requested by the write 
operation are not in the cache. 


Numerics 


2-path string. A series of physically connected DASD 
units in which the head of string unit provides two data 
transfer paths that can operate simultaneously. 


3380 track compatibility mode. A mode of operation in 
which a 3390 device manages its tracks as if they were 
3380 tracks. Contrast with 3390 mode. 


3390 mode. The mode of the actuator when the entire 
capacity of the 3390 device is initialized. Contrast with 
3380 track compatibility mode. 


4-path string. A series of physically connected DASD 
units in which the head of string provides four data 


_ transfer paths that can operate simultaneously. A 3390 
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4-path string requires one A-unit, while two 3380 Model 
AJ4/AK4 units are required for a 3380 4-path string. 
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Bibliography 


The bibliography is divided into two parts. The books listed in “Part One” and “Part Two” contain more detailed 
information on subjects discussed in the Storage Subsystem Library. For each book, the tables show the short and 


expanded title with the book’s order number, and a short description of its contents. 


“Part One— Hardware Publications” contains hardware information. Storage Subsystem Library publications, along 
with publications containing information on physical planning and reference, 3880 storage control, and storage 
hardware maintenance, are listed here. 
“Part Two— Software Publications” on page 83 contains software information related to various operating 
environments. Both parts are organized alphabetically by major heading, and alphabetically within each heading. 


For information on how to order these manuals, contact your local IBM branch office. 


Part One— Hardware Publications 


The books listed below contain more detailed information on hardware-related subjects discussed in the Storage 
Subsystem Library (SSL). Following the SSL publications, titles are arranged alphabetically by major heading, and 
alphabetically within each heading. | 


Short Title Full Title Order Number Contents 

Storage Subsystem Library Shared Manuals 

Maintaining IBM Storage Subsystem Maintaining IBM Storage Subsystem GC26-4495 Description of DASD media 

Media Media maintenance and error handling 

Master Index Storage Subsystem Library Master GC26-4496 Comprehensive bibliography, index, 

Bibliography, Index, and Glossary and glossary to information in 

Storage Subsystem Library 
publications 

Storage Subsystem Library 3380 DASD Manuals 

IBM 3380 Direct Access Storage IBM 3380 Direct Access Storage GC26-4491 Overview of all 3380 models 

Introduction Introduction 

IBM 3380 Direct Access Storage IBM 3380 Direct Access Storage Direct GC26-4497 Overview of functions and reference 

Direct Channel Attach Model CJ2 Channel Attach Mode! CJ2 Introduction information for 3380 Model CJ2 

Introduction and Reference and Reference 

3380 Direct Access Storage IBM 3380 Direct Access Storage: GX26-1678 Summary card containing 3380 

Reference Summary Reference Summary device characteristics 

Using the IBM 3380 Direct Access Using the IBM 3380 Direct Access GC26-4492 Discussion of 3380 use under 

Storage in an MVS Environment Storage in an MVS Environment MVS/ESA, MVS/XA, and MVS/370 

Using the IBM 3380 Direct Access Using the IBM 3380 Direct Access GC26-4493 Discussion of 3380 use under VM 

Storage in a VM Environment Storage ina VM Environment 

Using the IBM 3380 Direct Access Using the IBM 3380 Direct Access GC26-4494 Discussion of 3380 use under VSE 

Storage in a VSE Environment Storage in a VSE Environment 

Storage Subsystem Library 3390 DASD Manuals 

IBM 3390 Direct Access Storage IBM 3390 Direct Access Storage GC26-4573 Overview of all 3390 models 

introduction Introduction 

3390 Direct Access Storage IBM 3390 Direct Access Storage GX26-4577 Summary card containing 3390 

Reference Summary Reference Summary device characteristics 

Using IBM 3390 Direct Access Using IBM 3390 Direct Access Storage SC26-4574 Discussion of 3390 use under MVS. 

Storage in an MVS Environment in an MVS Environment 

Using IBM 3390 Direct Access Using IBM 3390 Direct Access Storage S$C26-4575 Discussion of 3390 use under VM. 

Storage in a VM Environment in a VM Environment 

Storage Subsystem Library 3990 Storage Control Manuals 

Cache Device Administration Cache Device Administration GC35-0101 Describes the IDCAMS cache utility 
commands necessary to manage 
cache and to obtain information 
about cache status and performance 

IBM 3990 Storage Control IBM 3990 Storage Control Introduction GA32-0098 Overview of 3.90 storage control unit 


Introduction 


© Copyright IBM Corp. 1987, 1989, 1991 


functions 


the User of IBM 3380 and 3390 Direct 
Access Storage 
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Short Title Full Title Order Number Contents 
IBM 3990 Storage Control Planning, IBM 3990 Storage Control Planning, GA32-0100 Detailed information on installation 
Installation, and Storage Installation, and Storage and use of the 3990 storage control 
Administration Guide Administration Guide 
IBM 3990 Storage Controi Reference IBM 3990 Storage Contro/ Reference GA32-0099 Information on the 3990 channel 
interface (channel commands and 
sense bytes) 
Other IBM Disk Storage Models 
_ 1BM 3370 Direct Access Storage IBM 3370 Direct Access Storage GA26-1657 Description of 3370 Direct Access 
Description Description Storage functions 
IBM 3375 Direct Access Storage IBM 3375 Direct Access Storage GA26-1666 Description of 3375 Direct Access 
Description and User’s Guide Description and User's Guide Storage functions 
IBM 9332 Disk Unit Models 200/400 IBM 9332 Disk Unit Models 200/400 $X21-9854 Set of publications covering 
Customer and Service Information Customer and Service information planning, installing, problem 
analysis, and service considerations 
for the IBM 9332 
IBM 9335 Direct-Access Storage IBM 9335 Direct-Access Storage SX33-6058 Set of publications describing disk _ 
Subsystem Customer Information Subsystem Customer Information functional characteristics and how to 
set up and use the IBM 9335 
Reference Manual for IBM 3330 Reference Manual for IBM 3330 Series GA26-1615 Reference material for 3330 Series 
Series Disk Storage Disk Storage Disk Storage 
Reference Manual for IBM 3340/3344 Reference Manual for IBM 3340/3344 GA26-1619 Reference material for 3340/3344 
Disk Storage Disk Storage Disk Storage 
Reference Manual for IBM 3350 Reference Manual for IBM 3350 Direct GA26-1638 Reference material for 3350 Direct 
Direct Access Storage Access Storage Access Storage 
Physical Planning and Reference 
information 
IBM 1/0 Equipment: Installation — IBM Input/Output Equipment: GC22-7069 Description of physical planning for 
Physical Planning for System/360, Installation — Physical Planning for I/O hardware 
System/370, and 4300 Processors System/360, System/370, and 4300 
Processors 
IBM System/360 System/370 4300 IBM System/360 System/370 4300 GC22-7064 Description of physical planning for 
Processors I/O Equipment Processors Input/Output Equipment /O hardware 
Installation Manual—Physical Installation Manual—Physical Planning 
Planning 
IBM 3031, 3032, 3033 Processor IBM 3031, 3032, 3033 Processor GG 22-9020 Provides guidance on configuring 
Complex Channel Configuration Complex Channel Configuration 303X processor channels 
Guidelines Guidelines 
IBM 3390 Direct Access Storage IBM 3390 Direct Access Storage GG 24-3373 Provides guidelines and detailed 
Migration Guide Migration Guide procedures for moving MVS and VM 
data to 3390 from other DASD 
IBM 360/370 OEM! manual IBM 360/370 Power Control Interface GA22-6906 Shows the interface specifications for 
Original Equipment Manufacturers remote power cables for the 3990. 
Information 
Introduction to IBM Direct Access Introduction to IBM Direct Access SR20-4738 Textbook describing large IBM early 
Storage Devices Storage Devices DASD and data storage theory and 
methods 
lIOCP User’s Guide and Reference Input/Output Configuration Program GC28-1027 Shows how to define the I/O 
User’s Guide and Reference configuration data required by the 
processor complex to control I/O 
requests, describing the MVS 
version, the VM version, and the 
standalone version of IOCP 
9370 Information System Installation 9370 Information System Installation GA24-4031 Contains physical planning 
Manual — Physical Planning Manual — Physical Planning information for the 9370 family of 
processors 
Storage Hardware Maintenance 
EREP User's Guide and Reference Environmental Record Editing and GC28-1378 Description of EREP functions and 
Printing (EREP) Program User’s Guide commands for DASD media reporting 
and Reference 
General Information and Planning for General Information and Planning for GC30-3463 Overview of NetView functions 
NetView Release 2 NetView Release 2 
ICKDSF Primer Device Support Facilities: Primer for GC26-4498 Describes how to use ICKDSF with 


the 3380 and 3390 


Short Title Full Title Order Number Contents 

ICKDSF User's Guide and Reference Device Support Facilities User's Guide GC35-0033 Description of ICKDSF functions and 
and Reference commands for DASD initialization 

and maintenance 

3880 Storage Control Information 

IBM 3880 Storage Control Models 1, IBM 3880 Storage Control Models 7, 2, GA26-1661 Overview of 3880 Models 1, 2, 3, and 

2, 3, and 4 Description 3, and 4 Description Manual 4 functions 

IBM 3880 Storage Control Model 11 IBM 3880 Storage Control Model 11 GA32-0061 Reference manual for 3880 Model 11 

Description Description functions 

IBM 3880 Storage Control Model 13 IBM 3880 Storage Contro/ Model 13 GA32-0067 Reference manual for 3880 Model 13 

Description Description functions 

IBM 3880 Storage Control Model 21 IBM 3880 Storage Control! Model 21 GA32-0081 Reference manual for 3880 Mode! 21 

Description Description functions 

IBM 3880 Storage Control Model 21 IBM 3880 Storage Control Model 21 GA32-0084 Reference manual for 3880 Model 21 

installation and Administration Guide Installation and Administration Guide functions . 

IBM 3880 Storage Contro! Mode! 23 IBM 3880 Storage Contro/ Modei 23 GA32-0083 Reference manual for 3880 Mode! 23 

Description Description functions 

IBM 3880 Storage Control Mode! 23 IBM 3880 Storage Control Model 23 GA32-0085 Describes how to install and use the 

Installation and Administration Guide Installation and Administration Guide 3880 Model 23 effectively 

IBM 3880 Storage Control Model 23 IBM 3880 Storage Control! Model 23 GA32-0082 Overview of 3880 Mode! 23 functions 

Introduction Introduction 

IBM 3880 Storage Control Model 23 IBM 3880 Storage Control! Model 23 GA32-0087 Reference manual for 3880 Mode! 23 

with RPQ #8B0035 Description with RPQ #8B0035 Description functions 

Introduction to IBM 3880 Storage Introduction to BM 3880 Storage GA32-0080 Overview of 3880 Model 21 functions 

Control! Mode! 21 Controi Mode! 21 

Introduction to IBM 3880 Storage Introduction to IBM 3880 Storage GA32-0086 Overview of 3880 Model 23 functions 


Control Model 23 with RPQ #8B0035 


Contro/ Mode! 23 with RPQ #8B0035 


Part Two— Software Publications 


The books listed below contain more detailed information on software-related subjects discussed in the Storage 
Subsystem Library. They are arranged alphabetically by major heading, and alphabetically within each heading. 


Short Title Full Title Order Number Contents 

DATABASE 2 (DB2) Information 

OBMAUI User’s Guide Data Base Migration Aid Utility User's SH20-9232 Describes how to migrate from one 

Guide - DB2 subsystem to another DB2 

subsystem 

DB2 Release 2 Data Portability DB2 Release 2 Data Portability GH20-9255 Describes moving DB2 data sets and 
volumes between DASD or systems 

IBM DB2 General Information IBM DATABASE 2 General Information GC26-4073 Overview of DB2 operation and 
functions 

IBM DB2 Installation IBM DATABASE 2 Installation SC26-4084 Describes installation requirements 
of DB2 

IBM DB2 System Planning and IBM DATABASE 2 System Planning and SC26-4085 Describes planning activities for 

Administration Guide Administration Guide installing or migrating to DB2 
Release 2 and managing system 

. resources once installed 

Data Facility Data Set Services 

(DFDSS) information 

DFDSS: General Information (Version Data Facility Data Set Services: GC26-4123 Overview of capabilities and 

2) General Information (Version 2) requirements 

DFDSS: User's Guide and Reference Data Facility Data Set Services: User’s SC26-4125 Describes syntax and usage of 

(Version 2, Release 3) Guide and Reference (Version 2, DFDSS commands 

Release 3) 

OFDSS: User’s Guide Version 2 Data Facility Data Set Services: User's SC26-4388 Describes usage of DFDSS 

Release 4 Guide Version 2, Release 4 commands 

DFDSS: Reference Version 2 Release Data Facility Data Set Services: SC26-4389 Describes syntax of DFDSS 

4 Reference Version 2 Release 4 commands 


Data Facility SORT (DFSORT) 
Information 
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Short Title Full Title a ~ Order Number — Contents 


DFSORT General Information DFSORT General Information ~GC33-403838 Contains introductory material for 
. planners, system support people, 
managers, or programmers 


DFSORT ee Programming DFSORT Application Programming | $C33-4035 . Provides detailed programming 


Guide Guide . . . information to enable programmers 
to prepare sort, merge or copy 
applications 


Data Facility Hierarchical Storage 
Manager (DFHSM) Information 


DFHSM: Installation and Data Facility Hierarchical Storage SH35-0084 Describes how to install and tailor 

Customization Guide Manager: Installation and DFHSM to your needs 
Customization Guide | 

DFHSM: System Programmer's Guide Data Facility Hierarchical Storage GH35-0085 _- Describes the concepts of DFHSM 
Manager: System Programmer's Guide | 

DFHSM: System Programmer's Data Facility Hierarchical Storage GH35-0083 Describes and explains how to use 

Reference Manager: System Programmer’s the DFHSM system programmer, 

. Reference = | . space manager, and operator 
a commands 


Data Facility Product (DFP) 


information 
MVS/DFP: General Information MVS/ESA Data Facility Product Version GC26-4507 - Overview of capabilities and — 
3: General Information requiremenis of MVS/DFP 
MVS Extended Architecture Data GC26-4142 Overview of capabilities and 
Facility Product Version 2: General requirements of MVS/XA DFP 
Information 
MVS/370 Data Facility Product: GC26-4050 Overview of capabilities and 
General Information requirements of MVS/370 DFP 
MVS/DFP Planning Guides MVS/ESA Data Facility Product Version $C26-4513 Describes installation of DFP 
3: Planning Guide 
MVS Extended Architecture Data GC26-4147 Describes installation of DFP, 
Facility Product Version 2: Planning conversion to integrated catalogs, 
Guide . . and conversion to indexed VTOCs in 
MVS/XA 
MVS/370 Data Facility Product: GC26-4052 Describes installation of DFP, 
Planning Guide conversion to integrated catalogs, 
and conversion to indexed VTOCs in 
MVS/370 
MVS/DFP: Diagnosis MVS/ESA Data Facility Product Version LY27-0550 Used to develop the keyword string 
3: Diagnosis Guide for reporting program failures . 
MVS/ESA Data Facility Product Version LY 27-9530 Used as references for diagnosing 
3: Diagnosis Reference | program failures 
MVS Extended Architecture Data LY27-9521 Used to develop the keyword string 
Facility Product Version 2: Diagnosis for reporting program failures. 
Guide | 
MVS/DFP Reference Information MVS/ESA Data Facility Product Version GC26-4414 References programming interfaces 
3: Directory of Programming Interfaces - documentation 
for Customers | 
MVS Extended Architecture Data LY 27-9530 Used as reference for diagnosing 
Facility Product Version 2: Diagnosis . program failures. 
| Reference — 
Storage Administration Reference MVS/ESA Storage Administration SC26-4514 Explains how to initialize, maintain, 
. Reference . and perform storage management 


tasks using the MVS/DFP Storage 
Management Subsystem (SMS) | 


DFSMS/VM Information 


DFSMS/VM General Information DFSMS/VM General Information GC26-4604 Provides introductory information on 
using DFSMS/VM to perform data 
and storage management tasks 


under VM 
Hierarchical Storage Manager 
{HSM) Information 
HSM Release 3 installation Guide Hierarchical Storage manage Release GG 22-9254 Describes requirements for and 
3 Installation Guide i activities of HSM installation 
OS/VS MVS HSM: General | .OS/VS MVS Hierarchical Storage GH35-0007 a Overview of capabilities and 
Information | Manager: General Information : requirements 
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Short Title Full Title . Order Number Contents 


OS/VS2 MVS HSM: User's Guide OS/VS2 MVS Hierarchical Storage SH35-0024 Describes syntax and usage of HSM 
Manager: User's Guide commands 

IMS/WVS Information 

Data Base Administration Guide IMS/VS Version 1, Data Base SH20-9025 Describes design, implementation 
Administration Guide and maintenance of IMS data base 

General Information Manual IMS/VS Version 1, General information GH20- 1260 Overview of capabilities and. 
Manual requirements 

Utilities Reference Manual IMS/VS Version 1, Utilities Reference SH26-4173 Provides detailed information on 
Manual utilities and how to run them 


Interactive Storage Management 
Facility (ISMF) Information 


ISMF User’s Guide MVS/ESA interactive Storage SC26-4508 Describes how to use ISMF to 
Management Facility User's Guide perform data and storage 
management tasks in an MVS/ESA 
environment 


MVS/XA Interactive Storage GC26-4266 Describes how to use ISMF to 

Management Facility User's Guide perform data and storage 
management tasks in an MVS/XA 
environment 


MVS/ESA Planning and Reference 


Information 
Access Method Services Reference MVS/ESA Integrated Catalog S$C26-4500 Describes access method services 
Administration: Access Method commands used to manipulate 
Services Reference integrated catalog facility catalogs 
and VSAM data sets 
MVS/ESA VSAM Catalog SC26-4501 Describes access method services 
Administration: Access Method commands used to manipulate VSAM 
Services Reference 7 data sets 
Basics of Problem Determination MVS/ESA Basics of Problem GC28- 1839 Describes the methods for problem 
Determination determination an MVS/ESA 
environment 
Catalog Administration Guide MVS/ESA Catalog Administration SC26-4052 Describes how to use the integrated 
| Guide catalog facility 
Data Administration Guide MVS/ESA Data Administration Guide SC26-4505 Describes how to use access 
methods (except VSAM) to process 
data sets 
Data Administration: Macro MVS/ESA Data Administration: Macro SC26-4506 Describes how to code macro 
Instruction Reference instruction Reference ' instructions for access methods 
Initialization and Tuning MVS/ESA System Programming GG 28-1828 Describes the effects of tuning an 
Library: Initialization and Tuning MVS/ESA system and how to define 
these values. 
JCL Reference . MVS/ESA Job Contro/ Language GC28-1829 Describes the syntax of JCL 
Reference 
JCL User’s Guide MVS/ESA Job Control Language User's GC28-1830 Describes the use of JCL 
Guide 
MVS Configuration Program Guide MVS/ESA MVS Configuration Program GC28-1817 Describes use of MVSCP to define 
and Reference Guide and Reference the I/O configuration to MVS/ESA 
Routing and Descriptor Codes MVS/ESA Message Library: Routing GC28-1816 Lists MVS/ESA system message 
and Descriptor Codes routing and descriptor codes 
Service Aids MVS/ESA System Programming GC28-1844 Describes how to use GTF, LIST, 
Library: Service Aids PRDMP, SADMP, and SPZAP 
Supervisor Services and Macro MVS/ESA Supervisor Services and GC28-1154 Provides supervisor services and 
Instructions Macro Instructions macro instruction information for 
MVS/ESA 
System Commands MVS/ESA Operations: System GC28- 1826 Describes syntax and use of 
Commands MVS/ESA system commands 
System: Data Administration MVS/ESA System: Data Administration $C26-4515 Overview of IBM access methods 
7 available in an MVS/ESA system 
System Generation MVS/ESA System Generation GC28-1825 Describes how to do a complete 
| | . sysgen MVS/ESA 
System Messages Volume 1 MVS/ESA Message Library: System GC28-1812 Lists MVS/ESA system messages 
a Messages Volume 1 4 and responses 
System Messages Volume 2 | MVS/ESA System Messages Volume 2 GC28-1813 Lists MVS/ESA system messages 


and responses 
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VSAM Administration Guide MVS/ESA VSAM Administration Guide SC26-4518 Describes how to create VSAM data 
sets 
MVS/XA Planning and Reference 
Information | 
An MVS Tuning Perspective An MVS Tuning Perspective | GG 22-9023 Describes the effects of tuning an 
MVS system mos 
Catalog Administration Guide MVS Extended Architecture Catalog GC26-4046 Describes how to use the integrated 
Administration Guide Catalog facility 
Data Administration Guide MVS Extended Architecture Data GC26-4140 Describes how to use access 
Administration Guide methods (except VSAM) to process 
data sets 
Data Administration: Macro MVS Extended Architecture Data GC26-4014 . Describes how to code macro 
Instruction Reference Administration: Macro Instruction instructions for access methods 
Reference 
Data Administration: Utilities MVS Extended Architecture Data GC26-4150 Describes how to use DFP utility - 
Administration: Utilities programs for data, device, and 
program management 
Installation: System Generation MVS/Extended Architecture GC26-4009 Describes how to do a complete 
Installation: System Generation sysgen, iogen, or edtgen in MVS/XA 
Integrated Catalog Administration: MVS Extended Architecture Integrated GC26-4135 Describes access method services 
Access Method Services Reference Catalog Administration: Access commands used to manipulate 
Method Services Reference integrated catalog facility catalogs 
and VSAM data sets 
MVS/XA I/O Performance MVS/XA I/O Performance GG 22-9346 Describes the effect of the MVS/XA 
Considerations Considerations /O subsystem on device 
MVS/XA JCL MVS/E xtended Architecture Job GC28-1148 Describes syntax and use of JCL in 
Contro! Language (JCL) MVS/XA | 
System Messages Volume 1 MVS/E xtended Architecture Message GC28-1376 Lists MVS/XA system messages and 
Library: System Messages Volume 1 responses 
System Messages Volume 2 MVS/Extended Architecture Message GC28-1377 Lists MVS/XA system messages and 
Library: System Messages Volume 2 responses 
MVS Configuration Program Guide MVS/Extended Architecture MVS GC28-1335 Describes use of MVSCP to define 
and Reference Configuration Program Guide and the I/O configuration to MVS/XA 
Reference 
Operations: System Commands MVS/Extended Architecture GC28-1206 Describes syntax and use of MVS/XA 
Operations: System Commands system commands 
System: Data Administration MVS Extended Architecture System: GC26-4149 Overview of IBM access methods 
Data Administration 
System Programming Library: MVS/Extended Architecture System GC28-1159 Describes how to use GTF, LIST, 
Service Aids Programming Library: Service Aids PRDMP, SADMP, and SPZAP 
VSAM Administration Guide MVS Extended Architecture VSAM GC26-4015 Describes how to create VSAM data 
Administration Guide sets 
VSAM Catalog Administration: MVS Extended Architecture VSAM GC26-4136 Describes access method services 
Access Method Services Reference Catalog Administration: Access Method commands used to manipulate VSAM 
Services Reference data sets . 
MVS/370 Planning and Reference 
Information 
Access Method Services Reference MVS/370 Integrated Catalog GC26-4051 Describes the access method 
Administration: Access Method services commands used with VSAM 
Services Reference and integrated catalog facility 
catalogs 
MVS/370 VSAM Catalog GC26-4059 Describes the access method 
Administration: Access Method services commands used with VSAM 
Services Reference 
Data Administration Guide MVS/370 Data Administration Guide GC26-4058 ~ Contains information on using access 
methods to do input and output 
Data Administration: Macro MVS/370 Data Administration: Macro GC26-4057 Describes how to use macros to do 
Instruction Reference Instruction Reference . input and output . 
Data Administration: Utilities MVS/370 Data Administration: Utilities GC26-4065 Describes how to use IEHLIST to 


maintain VTOC, IEHMOVE to 
maintain OS CVOLS, and IEHPROM 
to protect data sets 
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Initialization and Tuning Guide OS/VS2 MVS System Programming GC28-1029 Describes how to initialize the 
Library: Initialization and Tuning Guide system and improve system 
performance, includes information on 
GTF 
JCL User's Guide MVS/370 JCL User's Guide GC28-1349 Describes syntax of JCL statements, 
JES2 and JES3 control statements 
MVS Planning: Global Resource OS/VS2 MVS Planning: Global GC28-1062 Contains information on how to 
Serialization Guide Resource Serialization serialize access to data sets on 
shared DASD volumes 
MVS/SP Version 1 General MVS/System Product Version 1 GC28-1025 Contains overview and planning 
Information Manual General Information Manual information for JES3 and JES2 for 
MVS/370 
MVS/SP Version 1 Release 3 MVS/System Product Version 1 GG 22-9250 Installation planning considerations 
installation Considerations Release 3 Installation Considerations for MVS/370 
Operator's Library: OS/VS2 MVS Operator’s Library: OS/VS2 MVS GC28-1031 Describes syntax and use of MVS/370 
System Commands System Commands commands 
System: Data Administration MVS/370 System: Data Administration GC26-4056 Describes MVS/370 DFP, and how to 
modify and extend the data 
management capabilities of the 
| operating system 
System Generation Reference MVS/370 System Generation Reference GC26-4063 Describes how to do a sysgen, iogen, 
or edtgen 
VSAM Administration: Macro MVS/370 VSAM Administration: Macro GC26-4074 Describes using VSAM macro 
Instruction Reference Instruction Reference instructions for VSAM data sets 
MVS Storage Management Library 
MVS SML: Configuring Storage MVS Storage Management Library: SC26-4409 Describes evaluating hardware 
Subsystems Configuring Storage Subsystems configurations, developing capacity 
plans, and performance, availability 
and space utilization considerations 
MVS SML: Managing Data Sets MVS Storage Management Library: SC26-4408 Describes managing data sets, 
Managing Data Sets catalogs and control data sets. 
establishing and enforcing data set 
policy, and data set security 
MVS SML: Managing Storage Pools MVS Storage Management Library: SC26-4407 Describes storage require ments for 
Managing Storage Pools groups of data sets, designing 
storage pools, making transition to 
pooled storage, and maintaining and 
monitoring storage pools 
Performance, Availability, and 
Tuning Information 
Component Failure Impact Component Failure Impact GC20-1865 Planning for hardware availability 
Analysis—An Availability Analysis—An Availability Management through configuration 
Management Technique Technique 
MVS/XA: JES3 User Modifications MVS/Extended Architecture: JES3 User SC23-0060 Describes tailoring JES3 exits and 
and Macros Modifications and Macros macros 
Cache RMF Program Description and Cache RMF Reporter Program SH20-6295 Provides detailed information on 
Operation Description/Operation Cache RMF Reporter 
RMF Version 4 General Information MVS/ESA Resource Measurement GC28-1028 Describes capabilities, functions, and 
Facility Version 4 General Information usage of RMF (Version 4 runs on an 
MVS/ESA system) 
RMF Reference and User’s Guide MVS/ESA Resource Measurement LY28-1007 Provides detailed information to 
Facility Version 4 Monitor | and Ii operate RMF under MVS/ESA. 
Reference and User’s Guide 
RMF Reference and User’s Guide MVS/ESA Resource Measurement LY28-1008 Provides detailed information to 
Facility Version 4 Monitor Ill Reference operate RMF under MVS/ESA. 
and User's Guide 
MVS/XA RMF Reference and User's MVS/XA Resource Measurement LC28-1138 Provides detailed information to 
Guide Facility Reference and User’s Guide operate RMF under MVS/XA 
MVS/XA SMF MVS Extended Architecture System GC28-1153 Describes how to plan for, install and 
Management Facilities use SMF to manage the MVS/XA 
system 
OS/VS2 MVS Performance Notebook OS/VS2 MVS Performance Notebook GC28-0886 Describes tuning your system to 


meet performance expectations and 
optimizing use of your system 
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Short Title Full Title . Order Number Contents 
OS/VS2 MVS Planning: Global OS/VS2 MVS Planning: Global GC28-1062 Contains information on how to 
Resource Serialization Resource Serialization serialize access to data sets on 
shared DASD volumes 
RACF General Information Manual Resource Access Control Facility GC28-0722 Provides overview and planning 
| (RACF) General Information Manual information for the RACF program 
OS/VS2 MVS RMF Reference and OS/VS2 MVS RMF Reference and $C28-0922 Provides detailed information to 
User's Guide, Version 2 User's Guide, Version 2 operate RMF under MVS/370 
OS/VS2 System Programming Library OS/VS2 System Programming Library GC28-1030 Describes how to plan for, install and 
System Management Facilities System Management Facilities use SMF to manage the MVS/370 
system 
OS/VS2 MVS RMF, Version 2, OS/VS2 MVS Resource Measurement GC28-0921 Describes capabilities, functions, and 
General Information Facility, Version 2, General information usage of RMF (Version 2 runs on an 
MVS/370 system) 
RMF, Version 3, General Information Resource Measurement Facility, GC28-1115 Describes capabilities, functions, and 
Version 3, General Information usage of RMF (Version 3 runs on an 
MVS/XA system) 
SLR User's Guide Service Level Reporter User's Guide SH19-6215 Describes how generate reports 
using SLR 
SLR, Version 2, General Information Service Leve/ Reporter, Version 2, GH19-6213 Overview of SLR functions 
General information 
SPL: JES2 Installation, Initialization, System Programming Library: JES2 SC23-0046 Describes requireme nts for and 
and Tuning Installation, Initialization, and Tuning activities of JES2 installation, | 
initialization, and tuning 
SPL: JES3 Installation, Initialization, System Programming Library: JES3 $C23-0041 Describes requirements for and 
and Tuning Installation, Initialization, and Tuning activities of JES3 installation, 
initialization, and tuning» 
Transaction Processing Facility 
Information 
TPF2 General Information Manual Transaction Processing Facility Version GH20-6200 Provides an overview of TPF with a 
2 General Information Manual description of supported hardware 
VM System Installation, Operations, 
and Planning Information 
Installation VM/SP Installation Guide SC24-5237 Discussion of VM/SP installation 
tools, including the DISKMAP exec 
VM/SP HPO Installation Guide SC38-0107 Discussion of VM/SP HPO installation 
tools, including the DISKMAP exec 
VM/XA SF installation, Administration, GC19-6217 Discussion of VM/XA SF installation 
and Service tools, including the DISKMAP exec 
VM/XA SP Installation and Service SC23-0364 Discussion of system installation, 
definition, and maintenance in the 
VM/XA SP environment 
Operations VM/SP Operator’s Guide $C19-6202 Discussion of VM/SP operator 
commands and facilities, including 
DDR, MONITOR, VARY, and 
DMKFMT 
VM/SP HPO Operator's Guide (Release ST00-1898 Discussion of VM/SP HPO operator 
4.2) commands and facilities, including 
DDR, MONITOR, VARY, and 
DMKFMT 
VM/SP HPO Release 5 CP Support for GC23-0430 Describes the support of VM/SP HPO 
the IBM 3990 Storage Control! Model 3 Release 5 for the 3990 Model 3. 
VM/XA SF Real System Operation GC23-0139 Discussion of VM/XA SF operator 
commands and facilities, including 
DDR, MONITOR, VARY, and 
DMKFMT 
VM/XA SP Real System Operation $C23-0371 Discussion of VM/XA SP operator 
commands and facilities, including 
DDR, MONITOR, VARY, and 
DMKFMT 
VM/XA SF Virtual Machine Operation GC23-0138 Discussion of VM/XA SF operator 


commands and facilities 


88 Cache Device Administration 


( 
\ 


Ai it : 
i 
4 
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Planning VM/SP Planning Guide and Reference $C19-6201 Discussion of VM/SP hardware and 
software planning, system design, 
and system definition 


VM/SP HPO Planning Guide and $C 19-6223 Discussion of VM/SP HPO hardware 

Reference and software planning, system 
design, and system definition 

VM/XA SF Virtual Machine Planning S$C23-0167 Discussion of VM/XA SF hardware 


and software planning, system 
design, and system definition 


VM/XA SP Planning and Administration GC23-0378 Discussion of VM/XA SP hardware 
and software planning, system 
design, and system definition 


VM/XA Systems Facility Planning GG 24-1709 Provides advanced installation and 

Guide planning information for VM/XA SF, 
and includes planning information on 
MVS/370, MVS/XA, VSE and VM 
guests under VM/XA SF 


VM/integrated System Information 


VM/IS Planning For Your System VM/integrated System Planning For $C24-5337 Provides pre-installation planning 
Your System instructions for VM/IS and should be 
read before VM//S Installing Your 
System 
VM/IS Installing Your System VM/Integrated System Installing Your SC24-5341 Provides step-by-step instructions for 
System installing VM/IS; use this book in 
conjunction with VM/IS Planning For 
Your System 
VM/IS Managing Your System VM/integrated System Managing Your $C24-5338 Provides operation and 
System administration instructions for 
VM/integrated System 
VM/IS Reporting System Problems VM/Integrated System Reporting S$C24-5339 Provides problem reporting 
System Problems instructions for VM/IS and is based 


on VM/interactive Productivity 
Facility's Problem Control Facility 


VM/IS Learning to Use Your System: VM/integrated System Learning to Use S$C24-5351 Describes error and information 
Error and Information Messages Your System: Error and information messages produced by VM/IS; 
Messages includes cross-reference table to 


help locate messages produced by 
other products and functions 
included in VM/IS 


VM Performance and Monitor 


information 
VM/RTM Program VM/370 Real Time Monitor Program SH20-2337 Description of RTM functions, 
Description/Operations Manual Description/Operations Manual commands, and reports for 
performance monitoring 
RTM/SF Program VM/XA Realtime Monitor/Systems SH26-7000 Description of RTM/SF functions, 
Description/Operations Manual Facility Program commands, and reports for 
Description/Operations Manual performance monitoring 
VMBACKUP Management System VMBACKUP Management System GH20-6248 Overview of VUBACKUP and 
General Information General Information VMArchive functions for data backup 
and archival 
VM/Directory Maintenance General VM/Directory Maintenance General GC20-1836 Overview of DIRMAINT functions for 
Information Information directory maintenance 
VM/Directory Maintenance VM/Directory Maintenance Installation SC20-1840 Description of DIRMAINT 
Installation and System and System Administrator's Guide administrator commands 
Administrator's Guide 
VM/ISF General Information VM/Intersystems Facility General GC23-0397 Provides an overview of using 
Information VM/ISF for sharing minidisks 
VM/ISF Planning and Installation VM/intersystems Facility Planning and $C23-0399 Provides guidance and reference 
Installation information for those planning 


system resources’ usage for VM/ISF 
and for installers of VM/ISF 


VM/ISF Operation and Use VM/intersystems Facility Operation and $C23-0400 Describes operation of VM/ISF 
Use functions, and contains CP and CMS 
| command syntax and messages and 
codes for CP, CMS, and 
VM/Pass-Through Facility 


Bibliography 89 


Short Title Full Title Order Number Contents 
VMMAP General Information VM Monitor Analysis Program General GC34-2164 Overview of VMMAP functions for 
information performance monitoring 
VMMAP User’s Guide and Reference Virtual Machine Monitor Analysis $C34-2166 Description of VMMAP commands 
Program User's Guide and Reference and reports 
VM/PPF General Information VM Performance Planning Facility GC34-2126 Overview of VM/PPF functions for 
General information performance analysis and modeling 
VMPREF User Guide and Reference VM Performance Reporting Facility SC23-0460 Guide to VMPRF functions for 
(VMPRF) User Guide and Reference performance analysis and modeling 
VM Reference Information 
Alternate Pathing under VM Alternate Pathing under VM GG 22-9381 Description of how VM/SP uses 
alternate paths in the storage 
subsystem 
CMS Reference VM/SP CMS Command and Macro $C19-6209 Discussion of CMS commands, 
Reference (Release 4) including FORMAT and COPYFILE for 
VM/SP CMS Command Reference the VMISP and VM/SP HPO 
environments 
(Release 5) 
VM/XA SF CMS Command and Macro GC 19-6231 Discussion of CMS commands, 
Reference including FORMAT and COPYFILE 
VM/XA SP CMS Command Reference $C23-0354 Discussion of CUS commands, 
including FORMAT and COPYFILE 
Comparison of IBM 3380s and IBM Comparison of |BM 3380s and IBM GG 22-9347 Evaluates 3380 disk capacity and 
3350s Used for VM/CMS Minidisks 3350s Used for VM/CMS Minidisks. performance in VM/SP HPO 
CP for System Programming VM/SP CP for System Programming S$C24-5285 Discussion of system programming 
(Release 5) . tasks and commands, including CP 
INDICATE, SYSOWN, MONITOR 
VM/SP HPO CP for System $C 19-6224 Discussion of system programming 
Programming (Release 5) tasks and commands, including CP 
INDICATE, SYSOWN, MONITOR 
CP Reference VM/SP CP Command Reference $C19-6211 Discussion of CP commands for both 
general and non-general users 
VM/SP HPO CP Command Reference $C 19-6227 Discussion of CP commands for both 
general and non-general users 
VM/XA SF CP Command and Diagnosis GC19-6215 Discussion of CP commands for both 
Reference general and non-general users 
VM/XA SP CP Command Reference $C23-0358 Discussion of CP commands for both 
general and non-general users 
DASD Sharing under VM DASD Sharing under VM GG 22-9380 Description of how DASD can be 
shared among guest systems 
System Facilities for Programming | Virtual Machine System Facilities for $T24-5288 Discussion of system programming 
Programming (Release 5) tasks and commands, including DDR 
for both the VM/SP and VM/SP HPO 
environments 
System Logic and Problem VM/SP System Logic and Problem LY20-0893 Discussion of CMS file storage logic 
Determination Guide Volume 2—CMS Determination Guide Volume 2—CMS in the VM/SP and VM/SP HPO 
environments 
System Programmer's Guide VM/SP System Programmer's Guide $C19-6203 Discussion of system programming 
(Release 4) tasks and commands, including CP 
INDICATE, SYSOWN, MONITOR 
VM/SP HPO System Programmer’s ST00- 1897 Discussion of system programming 
Guide (Release 4.2) tasks and commands, including CP 
INDICATE, SYSOWN, MONITOR 
VM Running Guest Operating VM Running Guest Operating Systems GC19-6212 Discussion of guest operating 
Systems systems under VM 
VM/SP AJ4,BJ4,AK4,BK4 User's VM/SP IBM 3380 AJ4/BJ4/AK4/BK4 GC24-5371 Contains general description of 
Guide User's Guide VM/SP software support (within CP 
and CMS) for the Enhanced 
Subsystem 3380s. 
3380 VM Performance Analysis IBM 3380 Extended Capability DASD Helps plan migration from 3380 


VM Benchmark Performance Analysis 


GG66-0262 


standard modeis to 3380 extended 
Capability models, providing 
migration execs 


VSE System Information— 
Version 2 
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Short Title Full Title Order Number Contents 
VSE/AF System Control Statement VSE/Advanced Functions System SC33-6198 Description and syntax for VSE 
Control! Statements operator statements and commands 
VSE/AF System Management Guide VSE/Advanced Functions System $C33-6191 Description of system management 
Management Guide tasks under VSE/AF 
VSE/AF Operation VSE/Advanced Functions Operation $C33-6194 Various operational considerations 
including the PRINTLOG function 
VSE/POWER Installation and VSE/POWER Installation and Operation SH 12-5329 Description of VSE/POWER input and 
Operation Guide Guide output scheduling functions 
VSE/SP Installation VSE/System Package Installation SC33-6178 Assistance with regenerating VSE 
system files and libraries 
VSE/SP Migration (Volumes 1 and 2) VSE/System Package Migration S$C33-6179 Techniques for migration of system 
(Volumes 1 and 2) and user data and data bases 
VSE/SP System Use VSE/System Package Use SC33-6174 Use of Interactive Interface dialogs 
for tasks including storage 
management 
VSE/VSAM Programmer’s Reference VSE/VSAM Programmer's Reference $C24-5145 Detailed information on VSE/VSAM 
and converting non-VSAM files. 
VSE System Information— 
Version 3 
VSE/AF System Control Statement VSE/Advanced Functions System S$C33-6198 Description and syntax for VSE 
Control! Statements operator statements and commands 
VSE/AF System Management Guide VSE/Advanced Functions System SC33-6191 Description of system management 
Management Guide tasks under VSE/AF 
VSE/AF Operation VSE/Advanced Functions Operation SC33-6194 Various operational considerations 
including the PRINTLOG function 
VSE/POWER Application VSE/POWER Application Programming SC33-6276 information on using the system’s 
Programming accounting function 
VSE/POWER Installation and VSE/POWER Installation and Operation SH 12-5329 Description of VSE/POWER input and 
Operation Guide Guide output scheduling functions 
VSE/SP Administration VSE/System Package Administration SC33-6306 Use of Interactive Interface dialogs 
for tasks including storage 
management 
VSE/SP Installation VSE/System Package Installation $C33-6305 
VSE/SP Migration (Volumes 1 and 2) VSE/System Package Migration S$C33-6179 Techniques for migration of system 
(Volumes 1 and 2) and user data and data bases 
VSE/SP Operation VSE/System Package Operation SC33-6307 Use of Interactive Interface dialogs 
for tasks including storage 
management 
VSE/VSAM Programmer’s Reference VSE/VSAM Programmer's Reference SC24-5145 Detailed information on VSE/VSAM 
and converting non-VSAM files. 
VSE Reference Information 
DITTO Program Reference and Data Interfile Transfer, Testing and SH19-6104 Detailed information on using 
Operations Manual Operations Utility for VSE and VM VSE/DITTO 
Program Reference and Operations 
Manual 
DL1/DOS/VS Data Base DL1/DOS/VS Data Base Administration SH24-5011 Assistance with moving DL/1 data 
Administration bases 
DL1/DOS/VS Resource Definition and DL1/DOS/VS Resource Definition and SH24-5021 Assistance with moving DL/1 data 
Utilities Utilities bases 
VSE Fast Copy Data Set Installation DOS/VSE Fast Copy Data Set S$C33-6082 Specific information on using the 
Reference Installation Reference VSE/Fast Copy utility 
VSE/PT Program VSE/Performance Tool Program SH20-2171 Instructions for installation and use 
Description/Operations Manual Description/Operations Manual of optional VSE performance 
monitoring product 
VM Running Guest Operating VM Running Guest Operating Systems GC19-6212 Discussion of guest operating 
Systems systems under VM 
VMMAP User’s Guide and Reference Virtual Machine Monitor Analysis SC34-2166 Discussion of guest operating 


Manual 


Program User's Guide and Reference 


systems under VM 
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